Get Lead Action Logs

Fetch all action logs (activity history) for a specific lead

This endpoint fetches all action logs (activity history) for a specific lead. Action logs include messages, tool executions, follow-ups, and other agent actions.

Path Parameters

leadId · string · required

The unique identifier of the lead

Response

actionLogs · array

Array of action log objects

Show actionLogs

id · string

Unique identifier for the action log

type · string

Type of action (e.g., MESSAGE, FOLLOW_UP_MESSAGE, TOOL_CALL, MANUAL_UPDATE)

status · string

Status of the action (e.g., COMPLETED, PENDING, CANCELLED, AWAITING_APPROVAL, FAILED)

summary · string

Brief summary of the action

input · object

Input data for the action (structure varies by action type)

output · object

Output data from the action (structure varies by action type)

error · string

Error message if the action failed

parentActionId · string

ID of the parent action that triggered this action

scheduledAt · string

ISO 8601 timestamp when the action is scheduled (for future actions)

createdAt · string

ISO 8601 timestamp when the action was created

completedAt · string

ISO 8601 timestamp when the action was completed

tool · object

Tool information if this is a tool call action

Show tool

id · string

Unique identifier for the tool

name · string

Name of the tool

description · string

Description of what the tool does

messages · array

Array of messages associated with this action

Show messages

id · string

Unique identifier for the message

channel · string

Channel of the message (e.g., “EMAIL”, “SMS”)

direction · string

Direction of the message (e.g., “INBOUND”, “OUTBOUND”)

subject · string

Subject of the message (for email messages)

body · string

Body content of the message

documents · array

Array of documents attached to the message

Show documents

id · string

Unique identifier for the document

filename · string

Filename of the document

mimeType · string

MIME type of the document

size · number

Size of the document in bytes

Node.js

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}/action-logs`, options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));

200

[
  {
    "id": "25a6e7dc-2cdf-46b8-b0d5-9f1655ae154a",
    "type": "TOOL_CALL",
    "status": "COMPLETED",
    "summary": "Successfully executed deep research",
    "input": {
      "toolType": "deep_research",
      "companyInfo": "Vital Climbing Gym LLC",
      "instructions": "Conduct comprehensive company research"
    },
    "output": {
      "success": true,
      "summary": "Completed deep research for VITAL Climbing Gym...",
      "researchResult": {
        "address": "29990 Technology Dr, Unit 22, Murrieta, CA 92563",
        "companyName": "VITAL Climbing Gym (Vital Climbing, LLC)",
        "website": "https://www.vitalclimbinggym.com"
      }
    },
    "error": null,
    "parentActionId": null,
    "scheduledAt": "2025-09-07T23:51:06.209Z",
    "createdAt": "2025-09-07T23:51:06.210Z",
    "completedAt": "2025-09-07T23:54:29.052Z",
    "tool": {
      "id": "0a58309e-9657-4f35-a08d-4de9af03a5b7",
      "name": "update-checklist-item",
      "description": "Update a lead checklist item with a new value"
    },
    "messages": []
  },
  {
    "id": "e8ff3def-d6fc-40f7-902c-264d18fda1c5",
    "type": "FOLLOW_UP_MESSAGE",
    "status": "COMPLETED",
    "summary": "Requested business details to start loan application process",
    "input": {
      "channel": "EMAIL",
      "attemptNumber": 1,
      "adminTriggered": true,
      "missingItemsCount": 11
    },
    "output": {
      "isReply": false,
      "messageMetadata": {
        "to": ["[e-mail]"],
        "from": "Mark Ding <[e-mail]>",
        "subject": "Finishing up your application"
      }
    },
    "error": null,
    "parentActionId": null,
    "scheduledAt": "2025-09-07T23:56:21.587Z",
    "createdAt": "2025-09-07T23:56:21.588Z",
    "completedAt": "2025-09-07T23:56:45.426Z",
    "tool": null,
    "messages": [
      {
        "id": "a261a0ca-c77d-4226-a3f9-5cf63d0e8634",
        "channel": "EMAIL",
        "direction": "OUTBOUND",
        "subject": "Finishing up your application",
        "body": "Hi Anna,<br><br>This is Mark with Omni Capital...",
        "documents": []
      }
    ]
  }
]