Skip to main content
GET
https://api-v2.getomni.ai
/
api
/
v1
/
leads
/
:leadId
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}`, options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));

{
  "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",
  "actionLogs": [
    {
      "id": "372de835-c8cd-4791-abf6-485c679d31e5",
      "type": "FOLLOW_UP_MESSAGE",
      "status": "PENDING",
      "summary": "Request missing documents",
      "scheduledAt": "2025-10-15T16:00:00.000Z"
    }
  ],
  "nextFollowUp": {
    "id": "372de835-c8cd-4791-abf6-485c679d31e5",
    "type": "FOLLOW_UP_MESSAGE",
    "status": "PENDING",
    "scheduledAt": "2025-10-15T16:00:00.000Z",
    "summary": "Request missing documents"
  },
  "lastAction": {
    "id": "45a81f9c-01c8-4b72-94d9-f24e58c92aac",
    "type": "FOLLOW_UP_MESSAGE",
    "status": "COMPLETED",
    "completedAt": "2025-10-14T16:11:00.877Z"
  }
}
This endpoint fetches a single lead by ID, including detailed information about the lead’s status, checklist, and activity.

​
Path Parameters

​
leadId
string
required
The unique identifier of the lead

​
Response

​
id
string
Unique identifier for the lead
​
name
string
Lead name
​
email
string
Lead email address
​
phoneNumber
string
Lead phone number
​
businessName
string
Business name
​
status
string
Lead status (e.g., “IN_PROGRESS”)
​
activitySummary
string
Summary of recent activity
​
actionLogs
array
Array of action logs for this lead
​
nextFollowUp
object
Information about the next scheduled follow-up
​
lastAction
object
Information about the last action performed
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}`, options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));

{
  "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",
  "actionLogs": [
    {
      "id": "372de835-c8cd-4791-abf6-485c679d31e5",
      "type": "FOLLOW_UP_MESSAGE",
      "status": "PENDING",
      "summary": "Request missing documents",
      "scheduledAt": "2025-10-15T16:00:00.000Z"
    }
  ],
  "nextFollowUp": {
    "id": "372de835-c8cd-4791-abf6-485c679d31e5",
    "type": "FOLLOW_UP_MESSAGE",
    "status": "PENDING",
    "scheduledAt": "2025-10-15T16:00:00.000Z",
    "summary": "Request missing documents"
  },
  "lastAction": {
    "id": "45a81f9c-01c8-4b72-94d9-f24e58c92aac",
    "type": "FOLLOW_UP_MESSAGE",
    "status": "COMPLETED",
    "completedAt": "2025-10-14T16:11:00.877Z"
  }
}