Skip to Content
CallMitraDocs
API referenceLeads

Lead timeline

Calls, WhatsApp messages and orders, tickets, notes, lead changes and callbacks for one lead, newest first. Page with `cursor`; the first page also lists open callbacks.

GET
/api/v1/leads/{lead_id}/timeline

Calls, WhatsApp messages and orders, tickets, notes, lead changes and callbacks for one lead, newest first. Page with cursor; the first page also lists open callbacks.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

lead_id*Lead Id

Lead ID.

Query Parameters

cursor?|

nextCursor from the previous page.

limit?Limit

Items per page, 1 to 100 (default 30).

Range1 <= value <= 100
Default30
types?|

Comma list of call, whatsapp, ticket, note, change, callback.

Response Body

OK

application/json
  1. response

One page of a lead's timeline, newest first.

hasMore?|

True when another page follows.

items*array<>

Events on this page.

nextCursor?|

Pass as cursor for the next page; null on the last.

success?Success

Always true on a 2xx response.

Defaulttrue
upcomingCallbacks?array<>|

First page only: open callbacks and reminders, soonest first (callbackId, kind, channel, status, dueAt, dialAt, purpose, note, overdue).

[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/leads/string/timeline'
Example Response
{  "hasMore": true,  "items": [    {      "at": "string",      "body": "string",      "href": "string",      "id": "string",      "meta": {},      "title": "string",      "type": "string"    }  ],  "nextCursor": "string",  "success": true,  "upcomingCallbacks": [    {}  ]}