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

# List All AI Agents in Your Organization | DeltaLead

> GET /v1/agents — list all AI agents configured in your DeltaLead organization, including their status, language, and channel assignments.

This endpoint returns a paginated list of all AI agents configured in your DeltaLead organization. Each agent record includes its current status, the language it converses in, and the channels it is assigned to handle — giving you a full operational snapshot of your AI workforce at a glance.

## Endpoint

```http theme={null}
GET https://platform-api.deltalead.ai/v1/agents
```

## Query Parameters

<ParamField query="limit" type="integer" default="20">
  Maximum number of agents to return per page. Accepts values between `1` and `100`.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor returned in the previous response's `pagination.next_cursor` field. Omit this parameter to start from the beginning of the list.
</ParamField>

<ParamField query="status" type="string">
  Filter results by agent status. Accepted values: `active`, `inactive`, `draft`. Omit to return agents of all statuses.
</ParamField>

## Example Request

```bash cURL theme={null}
curl https://platform-api.deltalead.ai/v1/agents \
  -H "X-API-Key: YOUR_API_KEY"
```

## Response

<ResponseField name="data" type="array">
  Array of agent objects matching the query.

  <Expandable title="Agent object fields">
    <ResponseField name="id" type="string">
      Unique identifier for the agent, e.g. `agent_abc123`.
    </ResponseField>

    <ResponseField name="organization_id" type="string">
      ID of the organization this agent belongs to.
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name of the agent, e.g. `Martín de Ventas`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status of the agent: `active`, `inactive`, or `draft`.
    </ResponseField>

    <ResponseField name="language" type="string">
      Language locale the agent uses: `es-AR`, `es-MX`, `es-CR`, `es-CO`, `pt-BR`, or `en-US`.
    </ResponseField>

    <ResponseField name="channels" type="array">
      List of channels the agent handles: `whatsapp`, `facebook`, `instagram`, `web`, `email`, or `phone`.
    </ResponseField>

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

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of the most recent update to the agent.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata for the result set.

  <Expandable title="Pagination fields">
    <ResponseField name="limit" type="integer">
      The `limit` value applied to this request.
    </ResponseField>

    <ResponseField name="next_cursor" type="string | null">
      Cursor to pass as `cursor` in your next request to retrieve the following page. `null` when no further pages exist.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      `true` if additional pages of results are available.
    </ResponseField>
  </Expandable>
</ResponseField>

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "agent_abc123",
      "organization_id": "org_xyz789",
      "name": "Martín de Ventas",
      "status": "active",
      "language": "es-AR",
      "channels": ["whatsapp", "instagram"],
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-10-01T08:30:00Z"
    },
    {
      "id": "agent_def456",
      "organization_id": "org_xyz789",
      "name": "Ana Atención",
      "status": "active",
      "language": "es-CR",
      "channels": ["web", "email"],
      "created_at": "2024-03-20T14:00:00Z",
      "updated_at": "2024-09-15T11:00:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "next_cursor": null,
    "has_more": false
  }
}
```

<Note>
  `active` agents are currently handling live conversations. `inactive` agents are paused and will not respond to new messages. `draft` agents have been created but never published — they have not yet interacted with any leads.
</Note>