GET https://app.chatnorris.ai/api/v2/leads
Authorization: Bearer <tu_api_key>

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.

GET https://app.chatnorris.ai/api/v2/leads
Authorization: Bearer <tu_api_key>

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

{
  "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)

Listar mensajes Obtener lead

⌘I

​Listar leads

​Query parameters

​Respuesta

​Campos de respuesta

Listar leads

Query parameters

Respuesta

Campos de respuesta