> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Overview

Get a paginated list of all agents in your team.

## Request

#### Query Parameters

<ParamField path="offset" type="number" default={0}>
  The number of items to skip before starting to collect the result set
</ParamField>

<ParamField path="limit" type="number" default={4}>
  The maximum number of items to return
</ParamField>

## Response

<ResponseExample>
  ```json Response - 200 theme={null}
  {
    "data": [
      {
        "id": 1234567,
        "name": "Enterprise Sales Agent",
        "status": "ACTIVE",
        "createdAt": "2025-12-17T09:23:00.000Z"
      },
      {
        "id": 2345678,
        "name": "SMB Outreach Agent",
        "status": "ACTIVE",
        "createdAt": "2025-12-17T14:37:00.000Z"
      }
    ],
    "pagination": {
      "limit": 4,
      "offset": 0,
      "total": 2
    }
  }
  ```
</ResponseExample>

<ResponseField name="data" type="array">
  Array of agent objects

  <Expandable title="Agent properties">
    <ResponseField name="id" type="number">
      Unique identifier for the agent
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the agent
    </ResponseField>

    <ResponseField name="status" type="string">
      The current status of the agent
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp of when the agent was created
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination information

  <Expandable title="Pagination properties">
    <ResponseField name="limit" type="number">
      The maximum number of items returned in this response
    </ResponseField>

    <ResponseField name="offset" type="number">
      The number of items skipped
    </ResponseField>

    <ResponseField name="total" type="number">
      The total number of agents available
    </ResponseField>
  </Expandable>
</ResponseField>