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

**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

**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

**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

**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

```javascript Node.js theme={null}
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));
```

```python Python theme={null}
import requests

lead_id = '4ef30123-90c2-4dc0-bd28-b43eee8664ea'
url = f"https://api-v2.getomni.ai/api/v1/leads/{lead_id}/action-logs"
headers = {
    "x-api-key": "<your-api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())
```

```bash cURL theme={null}
curl --request GET \
  --url https://api-v2.getomni.ai/api/v1/leads/4ef30123-90c2-4dc0-bd28-b43eee8664ea/action-logs \
  --header 'x-api-key: <your-api-key>'
```

```json 200 theme={null}
[
  {
    "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": ["annapojawis@yahoo.com"],
        "from": "Mark Ding <support@agent.getomni.ai>",
        "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 Monumint Capital...",
        "documents": []
      }
    ]
  }
]
```


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