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

# Get Lead

> Retrieve a single lead with all associated data

This endpoint returns a single lead by ID along with its full checklist, documents, action logs, matching leads, and scheduling state. The response is the same standardized shape used by the create and update endpoints.

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Path Parameters

<ParamField path="leadId" type="string" required>
  The Omni lead ID to retrieve.
</ParamField>

## Response

<ResponseField name="lead" type="object">
  The lead record. Includes: id, activitySummary, assigneeType, businessName,
  createdAt, deletedAt, didOptOut, email, emailVerifiedAt, externalLeadId,
  externalPortalLink, firstName, isTest, lastName, phoneNumber, phoneVerifiedAt,
  source, submittedAt, updatedAt, website, workspaceId.
</ResponseField>

<ResponseField name="status" type="string">
  Computed lead status. One of: IN\_PROGRESS, COMPLETED, REVIEW, OPTED\_OUT.
</ResponseField>

<ResponseField name="checklistItems" type="array">
  Full checklist for the lead, grouped by checklist group. Each group includes
  id, name, conditions, and an items array. Each item includes id,
  checklistItemId, value, status, itemOverride, and a nested checklistItem with
  code, label, fieldType, conditions, validationRules, etc. File-type items
  include a documents array with presigned URLs.
</ResponseField>

<ResponseField name="documents" type="array">
  All documents uploaded for this lead, with presigned download URLs.
</ResponseField>

<ResponseField name="actionLogs" type="array">
  Recent action logs for the lead (up to 100), enriched with tool info,
  messages, and document presigned URLs.
</ResponseField>

<ResponseField name="matchingLeads" type="array">
  Leads that share the same phone number or email (empty for test leads).
</ResponseField>

<ResponseField name="lastAction" type="object" nullable>
  The most recent completed outbound message or follow-up action log, including
  associated tool calls.
</ResponseField>

<ResponseField name="nextFollowUp" type="object" nullable>
  The next pending follow-up message action log, if any.
</ResponseField>

<ResponseField name="nextDraft" type="object" nullable>
  The next message awaiting approval, if any.
</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/a9d0a790-201b-47e9-84ed-cc7eed1270c5",
    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/a9d0a790-201b-47e9-84ed-cc7eed1270c5"
  headers = {
      "x-api-key": "<your-api-key>",
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "lead": {
      "id": "a9d0a790-201b-47e9-84ed-cc7eed1270c5",
      "activitySummary": null,
      "assigneeType": "HUMAN_AGENT",
      "businessName": "Pacific Coast Container Haulers",
      "createdAt": "2026-01-30T02:00:00.000Z",
      "deletedAt": null,
      "didOptOut": false,
      "email": "john@example.com",
      "emailVerifiedAt": "2026-01-30T02:00:00.000Z",
      "externalLeadId": null,
      "externalPortalLink": null,
      "firstName": "John",
      "isTest": false,
      "lastName": "Doe",
      "phoneNumber": "+16782319992",
      "phoneVerifiedAt": null,
      "source": "api",
      "submittedAt": null,
      "updatedAt": "2026-01-30T02:00:00.000Z",
      "website": null,
      "workspaceId": "ws-123"
    },
    "status": "IN_PROGRESS",
    "checklistItems": [
      {
        "id": "group-id",
        "name": "Business Information",
        "conditions": null,
        "items": [
          {
            "id": "lci-1",
            "checklistItemId": "ci-1",
            "value": "Pacific Coast Container Haulers",
            "status": "COMPLETED",
            "itemOverride": null,
            "checklistItem": {
              "id": "ci-1",
              "code": "business_name",
              "label": "Business Name",
              "fieldType": "TEXT",
              "isRequired": true,
              "conditions": null
            }
          }
        ]
      }
    ],
    "documents": [],
    "actionLogs": [
      {
        "id": "log-1",
        "type": "API_ACTIVITY",
        "status": "COMPLETED",
        "summary": "Lead created",
        "createdAt": "2026-01-30T02:00:00.000Z"
      }
    ],
    "matchingLeads": [],
    "lastAction": null,
    "nextFollowUp": null,
    "nextDraft": null
  }
  ```
</ResponseExample>