Skip to Content
CallMitraDocs
API referenceLead notes

List a lead's notes

The first page carries the lead's summary note (`brief`) and pinned notes; `items` are the other notes, newest first. Follow `nextCursor` for older notes. Replaces the deprecated `notes` text field.

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

The first page carries the lead's summary note (brief) and pinned notes; items are the other notes, newest first. Follow nextCursor for older notes. Replaces the deprecated notes text field.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

lead_id*Lead Id

Lead ID.

Query Parameters

view?string

all, mine (notes you wrote), ai (AI-written) or imported.

Default"all"
Value in"all""mine""ai""imported"
cursor?|

nextCursor from the previous page.

limit?Limit

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

Range1 <= value <= 50
Default30

Response Body

OK

application/json
  1. response

One page of a lead's notes: the brief and pins (first page only), then newest first.

brief?|

The lead's summary note, on the first page only.

hasMore?|

Whether another page exists.

items?array<>|

Other notes, newest first.

nextCursor?|

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

notesCount?|

Live notes on the lead.

pinned?array<>|

Pinned notes (up to three), first page only.

[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/leads/string/notes'
Example Response
{  "hasMore": false,  "items": [    {      "authorKind": "api",      "body": "Asked for a call back after 6pm.",      "createdAt": "2026-05-04T10:15:00Z",      "id": "8a1f3c2e-5b7d-4e0a-9c61-2d4b8e7f0a13",      "kind": "note",      "leadId": "3f2c9d6e-1a4b-4c8d-9e0f-7a6b5c4d3e21",      "pinned": false,      "updatedAt": "2026-05-04T10:15:00Z",      "version": 1    }  ],  "notesCount": 2,  "pinned": [    {      "authorKind": "api",      "body": "Asked for a call back after 6pm.",      "createdAt": "2026-05-04T10:15:00Z",      "id": "8a1f3c2e-5b7d-4e0a-9c61-2d4b8e7f0a13",      "kind": "note",      "leadId": "3f2c9d6e-1a4b-4c8d-9e0f-7a6b5c4d3e21",      "pinned": true,      "pinnedAt": "2026-05-04T11:05:00Z",      "updatedAt": "2026-05-04T10:15:00Z",      "version": 2    }  ]}