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

# List Leads

> Fetch all leads in your workspace

This endpoint fetches all leads in your workspace.

## Response

<ResponseField name="leads" type="array">
  Array of lead objects
</ResponseField>

<ResponseField name="id" type="string">
  Unique identifier for the lead
</ResponseField>

<ResponseField name="name" type="string">
  Lead name
</ResponseField>

<ResponseField name="email" type="string" nullable>
  Lead email address
</ResponseField>

<ResponseField name="phoneNumber" type="string">
  Lead phone number
</ResponseField>

<ResponseField name="businessName" type="string">
  Business name
</ResponseField>

<ResponseField name="status" type="string">
  Lead status (e.g., "IN\_PROGRESS")
</ResponseField>

<ResponseField name="activitySummary" type="string">
  Summary of recent activity
</ResponseField>

<ResponseField name="completedChecklistItems" type="number">
  Number of completed checklist items
</ResponseField>

<ResponseField name="totalChecklistItems" type="number">
  Total number of checklist items
</ResponseField>

<ResponseField name="nextFollowUp" type="object" nullable>
  Information about the next scheduled follow-up
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: 'GET',
    headers: {
      'x-api-key': '<your-api-key>',
    },
  };

  fetch('https://api-v2.getomni.ai/api/v1/leads', options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  url = "https://api-v2.getomni.ai/api/v1/leads"
  headers = {
      "x-api-key": "<your-api-key>"
  }

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api-v2.getomni.ai/api/v1/leads \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "4ef30123-90c2-4dc0-bd28-b43eee8664ea",
      "name": "+14155099231",
      "email": null,
      "phoneNumber": "4155099231",
      "businessName": "Lexi",
      "status": "IN_PROGRESS",
      "activitySummary": "• Multiple documents submitted; some failed validation, checklist updated",
      "completedChecklistItems": 2,
      "totalChecklistItems": 6,
      "nextFollowUp": {
        "id": "372de835-c8cd-4791-abf6-485c679d31e5",
        "type": "FOLLOW_UP_MESSAGE",
        "status": "PENDING",
        "scheduledAt": "2025-10-15T16:00:00.000Z",
        "summary": "Request missing documents"
      }
    }
  ]
  ```
</ResponseExample>