> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monumint.com/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.

To see which workflows agents are conducting on this lead, use [List Workflow Runs](https://docs.monumint.com/api-reference/workflow-runs/list-workflow-runs.md).

## Authentication

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

## Path Parameters

**leadId** `string` *required*

The Monumint lead ID to retrieve.

## Response

**lead** `object`

The lead record. Includes: id, assigneeType, businessName,
createdAt, deletedAt, didOptOut, email, emailVerifiedAt, externalLeadId,
externalPortalLink, firstName, isTest, lastName, phoneNumber, phoneVerifiedAt,
source, submittedAt, tags, updatedAt, website, workspaceId.

**status** `string`

Computed lead status. One of: IN\_PROGRESS, COMPLETED, REVIEW, NOT\_INTERESTED, OPTED\_OUT.

**checklistItems** `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.

**documents** `array`

All documents uploaded for this lead, with presigned download URLs.

**actionLogs** `array`

Recent action logs for the lead (up to 100), enriched with tool info,
messages, and document presigned URLs.

**matchingLeads** `array`

Leads that share the same phone number or email (empty for test leads).

```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>'
```

```json 200 theme={null}
{
  "lead": {
    "id": "a9d0a790-201b-47e9-84ed-cc7eed1270c5",
    "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,
    "tags": ["VIP", "priority-1"],
    "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": []
}
```


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