Leads

Get lead timeline

Everything that has happened to this lead — notes, status changes, sequence steps, calls, emails and SMS — newest first.

This endpoint is cursor-paginated rather than page and pageSize like the rest of the API. The feed merges several tables and new rows arrive while you page, so an offset would skip or repeat entries. Pass the returned nextCursor back as cursor to fetch the next page, and stop when hasMore is false.

Entries share id, kind and timestamp and then carry whatever else that kind has, so read them defensively.

GET

leads

{id}

timeline

Get lead timeline

curl --request GET \
  --url https://backend.leadey.ai/v1/leads/{id}/timeline \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://backend.leadey.ai/v1/leads/{id}/timeline', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "id": "call_3Zm6yPdL",
        "kind": "call",
        "timestamp": "2026-08-03T11:04:12.000Z",
        "leadId": "lead_8Kq2mXvR",
        "funnelId": "fnl_Q3OutboundUK",
        "funnelName": "Q3 outbound, UK logistics",
        "contact": {
          "personKey": "mc_9Yv3sHnD",
          "masterContactId": "mc_9Yv3sHnD",
          "name": "Priya Raman"
        },
        "call": {
          "id": "call_3Zm6yPdL",
          "direction": "outbound",
          "from": "manual",
          "to": "+442071838750",
          "contactName": "Priya Raman",
          "companyName": "Northwind Logistics",
          "duration": 412,
          "disposition": "completed",
          "outcome": "connected",
          "outcomeManual": true,
          "summary": "Wants a proposal for 240 vehicles.",
          "hasRecording": true
        }
      },
      {
        "id": "event_6Tk9wRmB",
        "kind": "event",
        "timestamp": "2026-08-03T11:09:20.000Z",
        "leadId": "lead_8Kq2mXvR",
        "funnelId": "fnl_Q3OutboundUK",
        "funnelName": "Q3 outbound, UK logistics",
        "contact": {
          "personKey": "mc_9Yv3sHnD",
          "masterContactId": "mc_9Yv3sHnD",
          "name": "Priya Raman"
        },
        "event": {
          "type": "note",
          "outcome": null,
          "stepIndex": 0,
          "meta": {
            "text": "Asked for pricing on a 240-vehicle fleet.",
            "userId": "user_2pXn4Rk"
          }
        }
      }
    ],
    "nextCursor": "MjAyNi0wOC0wMyAxMTowNDoxMi4wMDAwMDArMDB8Y2FsbF8zWm02eVBkTA==",
    "hasMore": true
  }
}

{
  "error": {
    "message": "Invalid or revoked API key.",
    "details": null
  }
}

{
  "error": {
    "message": "Lead not found",
    "details": null
  }
}

{
  "error": {
    "message": "Rate limit exceeded. Retry in 42s.",
    "details": null
  }
}

Authorizations

Authorization

string

header

required

Your API key, created in the Leadey dashboard under Settings → API Keys. Send it as Authorization: Bearer leadey_sk_live_….

Path Parameters

string

required

The lead id.

Query Parameters

limit

integer

default:50

Entries per page, 1 to 100. Defaults to 50.

Required range: 1 <= x <= 100

cursor

string

The nextCursor from the previous page. Omit for the first page.

types

string

Comma-separated entry kinds to include, for example call,email. Defaults to everything.

Response

A page of the lead's history.

data

object

required

Show child attributes

Get lead timeline

curl --request GET \
  --url https://backend.leadey.ai/v1/leads/{id}/timeline \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://backend.leadey.ai/v1/leads/{id}/timeline', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "id": "call_3Zm6yPdL",
        "kind": "call",
        "timestamp": "2026-08-03T11:04:12.000Z",
        "leadId": "lead_8Kq2mXvR",
        "funnelId": "fnl_Q3OutboundUK",
        "funnelName": "Q3 outbound, UK logistics",
        "contact": {
          "personKey": "mc_9Yv3sHnD",
          "masterContactId": "mc_9Yv3sHnD",
          "name": "Priya Raman"
        },
        "call": {
          "id": "call_3Zm6yPdL",
          "direction": "outbound",
          "from": "manual",
          "to": "+442071838750",
          "contactName": "Priya Raman",
          "companyName": "Northwind Logistics",
          "duration": 412,
          "disposition": "completed",
          "outcome": "connected",
          "outcomeManual": true,
          "summary": "Wants a proposal for 240 vehicles.",
          "hasRecording": true
        }
      },
      {
        "id": "event_6Tk9wRmB",
        "kind": "event",
        "timestamp": "2026-08-03T11:09:20.000Z",
        "leadId": "lead_8Kq2mXvR",
        "funnelId": "fnl_Q3OutboundUK",
        "funnelName": "Q3 outbound, UK logistics",
        "contact": {
          "personKey": "mc_9Yv3sHnD",
          "masterContactId": "mc_9Yv3sHnD",
          "name": "Priya Raman"
        },
        "event": {
          "type": "note",
          "outcome": null,
          "stepIndex": 0,
          "meta": {
            "text": "Asked for pricing on a 240-vehicle fleet.",
            "userId": "user_2pXn4Rk"
          }
        }
      }
    ],
    "nextCursor": "MjAyNi0wOC0wMyAxMTowNDoxMi4wMDAwMDArMDB8Y2FsbF8zWm02eVBkTA==",
    "hasMore": true
  }
}

{
  "error": {
    "message": "Invalid or revoked API key.",
    "details": null
  }
}

{
  "error": {
    "message": "Lead not found",
    "details": null
  }
}

{
  "error": {
    "message": "Rate limit exceeded. Retry in 42s.",
    "details": null
  }
}

Account

Leads

Notes

Campaigns

Metrics

Companies

Contacts

Meetings

Opportunities

Pipelines

Calls

Tasks

Reference

Get lead timeline

Authorizations

Path Parameters

Query Parameters

Response