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

# List leads

> List all leads for the authenticated user with filtering and pagination options

This endpoint allows you to list all leads belonging to the authenticated user with various filtering and pagination options.

### Query Parameters

**status** `string`

Filter leads by status. Possible values: `created`, `scheduled`, `processing`, `completed`, `rescheduled`, `reached-max-retries`, `blacklisted`

**campaign\_id** `integer`

Filter leads by campaign ID

**phone\_number** `string`

Filter leads by phone number (partial match supported)

**date\_from** `string`

Filter leads created from this date (YYYY-MM-DD format)

**date\_to** `string`

Filter leads created until this date (YYYY-MM-DD format)

**per\_page** `integer`

Number of leads per page (1-100, default: 15)

**page** `integer`

Page number (default: 1)

### Response fields

**data** `array`

**properties**

**id** `integer`

The id of the lead

**campaign\_id** `integer`

The ID of the campaign this lead belongs to

**phone\_number** `string`

The phone number of the lead in E.164 format

**variables** `object`

The variables associated with the lead

**status** `string`

The status of the lead

**created\_at** `string`

The created at date of the lead

**updated\_at** `string`

The updated at date of the lead

**campaign** `object`

The campaign information

**campaign properties**

**id** `integer`

The id of the campaign

**name** `string`

The name of the campaign

**secondary\_contacts** `array`

Array of secondary contact leads associated with this lead

**secondary\_contacts properties**

**id** `integer`

The id of the secondary contact lead

**phone\_number** `string`

The phone number of the secondary contact in E.164 format

**variables** `object`

The variables associated with the secondary contact

**status** `string`

The status of the secondary contact

**created\_at** `string`

The created at date of the secondary contact

**updated\_at** `string`

The updated at date of the secondary contact

**current\_page** `integer`

The current page number

**per\_page** `integer`

Number of items per page

**total** `integer`

Total number of leads matching the criteria

**last\_page** `integer`

The last page number

```json 200 Response theme={null}
{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "campaign_id": 1,
      "phone_number": "+1234567890",
      "variables": {
        "customer_name": "John Doe",
        "email": "john.doe@example.com"
      },
      "status": "created",
      "created_at": "2025-06-30 11:18:04",
      "updated_at": "2025-06-30 11:18:04",
      "campaign": {
        "id": 1,
        "name": "My new campaign"
      },
      "secondary_contacts": [
        {
          "id": 2,
          "phone_number": "+1234567899",
          "variables": {
            "customer_name": "Jane Doe Secondary",
            "email": "jane.doe.secondary@example.com"
          },
          "status": "created",
          "created_at": "2025-06-30 11:18:04",
          "updated_at": "2025-06-30 11:18:04"
        }
      ]
    }
  ],
  "first_page_url": "https://app.lacy.ai/api/user/leads?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://app.lacy.ai/api/user/leads?page=10",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.lacy.ai/api/user/leads?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.lacy.ai/api/user/leads?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.lacy.ai/api/user/leads?page=2",
  "path": "https://app.lacy.ai/api/user/leads",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}
```


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