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

# Leads

> Learn how to managed your AI chatbot leads with the Support AI leads API endpoints.

Leads are users who input their information into the Support AI chatbot for additional communications.

### Properties

<ParamField body="lead_id" type="integer">
Unique identifier for the lead.
</ParamField>

<ParamField body="lead_date" type="string">
The date the lead was created.
</ParamField>

<ParamField body="country" type="string">
The country of origin for the lead.
</ParamField>

<ParamField body="email" type="string">
The email of the lead.
</ParamField>

<ParamField body="name" type="string">
The name of the lead.
</ParamField>

<ParamField body="phone" type="string">
The phone number of the lead.
</ParamField>

***

**GET** /listLeads/:chatbot_id

## Fetch all leads

Get a list of all leads of a specific chatbot of your account.

### Request

**GET** /listLeads/:chatbot_id

```bash
curl --request GET \
  --url https://api.supportai.com/listLeads/:chatbot_id \
  --header 'Authorization: Bearer IDZFdfiD...'
```

### Response

```json
{
  "success": true,
  "data": [
    {
      "lead_id": 123...,
      "lead_date": "2024-01-16T22:43:53.892531+00:00",
      "country": "US",
      "email": "lead@email.com",
      "name": "John Smith",
      "phone": "310 000-0000"
    }
    ...
  ]
}
```

---

This knowledge base is built and hosted on [Weav](https://weav.com).
