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

# Get lead

> Retrieve a specific lead by its ID.

# Get lead

Returns the data of a specific lead.

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

**Required scope:** `leads:read`

***

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `lead_id` | string | Lead ID |

***

## Response

```json theme={null}
{
  "status": "success",
  "data": {
    "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"
    },
    "channel": "whatsapp",
    "contact_properties": {
      "company": "Empresa SA",
      "job_title": "Purchasing manager"
    },
    "custom_fields": {
      "Company": "Empresa SA"
    },
    "created_at": "2026-06-25T11:30:00.000Z"
  }
}
```

***

## Response fields

See the details of each field (including `channel`, `contact_properties` and `custom_fields`) in [List leads](https://docs.chatnorris.ai/en/api-referencia/leads/listar.md#response-fields).

***

## Common errors

| Code | Description |
| - | - |
| `NOT_FOUND` | The lead doesn't exist, was deleted or doesn't belong to your organization |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.