---
title: "List Leads"
method: GET
path: "/user/leads"
tags: ["Leads"]
---

# List Leads

`GET /user/leads`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/leads`
- Auth: HTTP bearer

Retrieve a paginated list of all leads for the authenticated Famulor account via API. Filter, sort and access contact details for voice agent campaigns.

[Docs](https://docs.famulor.io/api-v1/leads/list)

## Query parameters

- `status` 'created' | 'scheduled' | 'processing' | 'completed' | 'rescheduled' | 'reached-max-retries' | 'blacklisted'
- `campaign_id` integer
- `phone_number` string
- `date_from` string
- `date_to` string
- `per_page` integer
- `page` integer

## Response `200`

Response

- object
  - `data` object[]: List of leads
    - `id` integer: The ID of the lead
    - `campaign_id` integer: The ID of the campaign this lead belongs to
    - `phone_number` string: The lead's phone number in E.164 format
    - `variables` object: The variables assigned to the lead
    - `status` string: The status of the lead
    - `created_at` string: The creation date of the lead
    - `updated_at` string: The date of the last update of the lead
    - `campaign` object: The campaign information
      - `id` integer: The ID of the campaign
      - `name` string: The name of the campaign
    - `secondary_contacts` object[]: Array of secondary contact leads linked to this lead
      - `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 assigned to the secondary contact
      - `status` string: The status of the secondary contact
      - `created_at` string: The creation date of the secondary contact
      - `updated_at` string: The date of the last update 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

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)