Leads

Leads in a list, oldest first, cursor-paged

Scope: leads:read. format=csv returns text/csv with X-Has-More and X-Next-Cursor headers.

get/lists/{id}/leads

Request

  • Base URL: https://mcp.senders.ai/api/v1
  • URL: https://mcp.senders.ai/api/v1/lists/{id}/leads
  • Auth: HTTP bearer

Path parameters

idinteger required

List id

Query parameters

limitinteger

Items per page, 1-500

cursorstring

next_cursor from the previous page; omit for the first page

sincestring
Example:2026-10-01

Only items added at or after this time (UTC). YYYY-MM-DD or ISO 8601.

max_priorityinteger

Only leads with research priority 1..N

format'csv'

csv for a CSV download

Response

OK

has_moreboolean required
next_cursorstring nullable required

Cursor after the last item. Save it to resume; null only when the page is empty and no cursor was sent.

Changes

No recorded changes to this operation across all 1 revision of this API.