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

# Listar leads

> Obtener la lista paginada de leads capturados por tus agentes.

# Listar leads

Devuelve todos los leads capturados por los agentes de la organización, ordenados por fecha de creación descendente. Se puede filtrar por agente.

<RequestExample>
  ```http theme={null}
  GET https://app.chatnorris.ai/api/v2/leads
  Authorization: Bearer <tu_api_key>
  ```
</RequestExample>

**Scope requerido:** `leads:read`

***

## Query parameters

| Parámetro    | Tipo    | Descripción                                        |
| ------------ | ------- | -------------------------------------------------- |
| `chatbot_id` | string  | Filtrar leads de un agente específico              |
| `page`       | integer | Número de página. Default: `1`                     |
| `per_page`   | integer | Resultados por página. Default: `25`, máximo `100` |

***

## Respuesta

```json theme={null}
{
  "status": "success",
  "data": {
    "leads": [
      {
        "id": "lead_abc123",
        "chatbot_id": "bot_xyz789",
        "conversation_id": "conv_def456",
        "name": "María García",
        "email": "maria@empresa.com",
        "phone": "+5491112345678",
        "extra_data": {
          "company": "Empresa SA"
        },
        "created_at": "2026-06-25T11:30:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 25,
    "total": 112
  }
}
```

### Campos de respuesta

| Campo             | Tipo           | Descripción                       |
| ----------------- | -------------- | --------------------------------- |
| `id`              | string         | ID único del lead                 |
| `chatbot_id`      | string         | ID del agente que capturó el lead |
| `conversation_id` | string         | ID de la conversación asociada    |
| `name`            | string \| null | Nombre del lead                   |
| `email`           | string \| null | Email del lead                    |
| `phone`           | string \| null | Teléfono del lead                 |
| `extra_data`      | object \| null | Datos adicionales capturados      |
| `created_at`      | string         | Fecha de captura (ISO 8601)       |