Skip to main content
GET
/
api
/
v1
/
leads
/
:leadId
/
checklist
const leadId = '4ef30123-90c2-4dc0-bd28-b43eee8664ea';
const options = {
  method: 'GET',
  headers: {
    'x-api-key': '<your-api-key>',
  },
};

fetch(`https://api-v2.getomni.ai/api/v1/leads/${leadId}/checklist`, options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));
[
  {
    "id": "2490cb41-4e65-47bc-a662-54e05ac8133d",
    "name": "Business Information",
    "items": [
      {
        "id": "a61b8be3-5f89-413b-b0eb-454a569bb06b",
        "checklistItemId": "5f71c15b-0022-4b72-b1bf-daf7a76486f5",
        "value": "Lexi",
        "status": "COMPLETED",
        "checklistItem": {
          "id": "5f71c15b-0022-4b72-b1bf-daf7a76486f5",
          "code": "BUSINESS_NAME",
          "label": "Business Name",
          "fieldType": "TEXT",
          "isRequired": true
        }
      },
      {
        "id": "d78cbb58-5a6e-4fc3-8622-b783b3211b3f",
        "checklistItemId": "2f791c62-6a04-4d29-b7fa-477b777800f6",
        "value": null,
        "status": "TODO",
        "checklistItem": {
          "id": "2f791c62-6a04-4d29-b7fa-477b777800f6",
          "code": "EIN",
          "label": "EIN",
          "fieldType": "EIN",
          "isRequired": true
        }
      }
    ]
  }
]
This endpoint fetches the checklist for a specific lead, including all checklist groups, items, and their current status.

Path Parameters

leadId
string
required
The unique identifier of the lead

Response

checklist
array
Array of checklist groups
id
string
Checklist group ID
name
string
Checklist group name
items
array
Array of checklist items in this group
checklistItemId
string
ID of the checklist item
value
string
Current value for this checklist item
status
string
Status of the checklist item (e.g., “COMPLETED”, “TODO”)
checklistItem
object
Details about the checklist item definition
checklistItem.code
string
Code identifier for the checklist item
checklistItem.label
string
Display label for the checklist item
checklistItem.fieldType
string
Field type (e.g., “TEXT”, “FILE”, “DATE”, “ADDRESS”, “EIN”)
checklistItem.isRequired
boolean
Whether this item is required
const leadId = '4ef30123-90c2-4dc0-bd28-b43eee8664ea';
const options = {
  method: 'GET',
  headers: {
    'x-api-key': '<your-api-key>',
  },
};

fetch(`https://api-v2.getomni.ai/api/v1/leads/${leadId}/checklist`, options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));
[
  {
    "id": "2490cb41-4e65-47bc-a662-54e05ac8133d",
    "name": "Business Information",
    "items": [
      {
        "id": "a61b8be3-5f89-413b-b0eb-454a569bb06b",
        "checklistItemId": "5f71c15b-0022-4b72-b1bf-daf7a76486f5",
        "value": "Lexi",
        "status": "COMPLETED",
        "checklistItem": {
          "id": "5f71c15b-0022-4b72-b1bf-daf7a76486f5",
          "code": "BUSINESS_NAME",
          "label": "Business Name",
          "fieldType": "TEXT",
          "isRequired": true
        }
      },
      {
        "id": "d78cbb58-5a6e-4fc3-8622-b783b3211b3f",
        "checklistItemId": "2f791c62-6a04-4d29-b7fa-477b777800f6",
        "value": null,
        "status": "TODO",
        "checklistItem": {
          "id": "2f791c62-6a04-4d29-b7fa-477b777800f6",
          "code": "EIN",
          "label": "EIN",
          "fieldType": "EIN",
          "isRequired": true
        }
      }
    ]
  }
]