> ## 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.

# Listar todos los agentes de IA de la organización | DeltaLead

> GET /v1/agents — lista todos los agentes de IA configurados en la organización de DeltaLead, con su estado, su idioma y los canales asignados.

Este endpoint devuelve una lista paginada de todos los agentes de IA configurados en la organización de DeltaLead. Cada registro incluye el estado actual del agente, el idioma en el que conversa y los canales que tiene asignados, de modo que basta una lectura para tener el panorama operativo completo de la dotación de agentes de IA.

## Endpoint

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

## Parámetros de consulta

<ParamField query="limit" type="integer" default="20">
  Cantidad máxima de agentes que se devuelven por página. Acepta valores entre `1` y `100`.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor de paginación devuelto en el campo `pagination.next_cursor` de la respuesta anterior. Si se omite este parámetro, la lectura empieza por el comienzo de la lista.
</ParamField>

<ParamField query="status" type="string">
  Filtra los resultados por estado del agente. Valores aceptados: `active`, `inactive`, `draft`. Si se omite, se devuelven los agentes de todos los estados.
</ParamField>

## Solicitud de ejemplo

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

## Respuesta

<ResponseField name="data" type="array">
  Arreglo de objetos de agente que coinciden con la consulta.

  <Expandable title="Campos del objeto de agente">
    <ResponseField name="id" type="string">
      Identificador único del agente, por ejemplo `agent_abc123`.
    </ResponseField>

    <ResponseField name="organization_id" type="string">
      ID de la organización a la que pertenece el agente.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nombre visible del agente, por ejemplo `Martín de Ventas`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado actual del agente: `active`, `inactive` o `draft`.
    </ResponseField>

    <ResponseField name="language" type="string">
      Configuración regional de idioma que usa el agente: `es-AR`, `es-MX`, `es-CR`, `es-CO`, `pt-BR` o `en-US`.
    </ResponseField>

    <ResponseField name="channels" type="array">
      Lista de canales que atiende el agente: `whatsapp`, `facebook`, `instagram`, `web`, `email` o `phone`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Marca de tiempo ISO 8601 del momento en que se creó el agente.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Marca de tiempo ISO 8601 de la actualización más reciente del agente.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Metadatos de paginación del conjunto de resultados.

  <Expandable title="Campos de paginación">
    <ResponseField name="limit" type="integer">
      El valor de `limit` aplicado a esta solicitud.
    </ResponseField>

    <ResponseField name="next_cursor" type="string | null">
      Cursor que se pasa como `cursor` en la solicitud siguiente para recuperar la próxima página. Es `null` cuando no quedan más páginas.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      `true` si hay páginas adicionales de resultados disponibles.
    </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>
  Los agentes `active` están atendiendo conversaciones en vivo. Los agentes `inactive` están pausados y no responden a mensajes nuevos. Los agentes `draft` fueron creados pero nunca publicados: todavía no interactuaron con ningún lead.
</Note>