Sales Engine
API documentation
Lead listsOperation leadLists.leads

List the leads in a list

Leads in a list.

GET/api/v1/lead-lists/{id}/leads
Scope read: Read anything in the workspace.

Parameters

Path

NameInDescription
idrequiredpathThe record's id.

Query

NameInDescription
qquerySearch text.
stagequeryPipeline stage.
email_statusqueryvalid, catch_all, invalid, unknown.
limitquery, integerRows.
offsetquery, integerOffset.

Example

curl
curl -X GET "https://crm.ashwanth.dev/api/v1/lead-lists/{id}/leads" \
  -H "Authorization: Bearer $SALES_ENGINE_API_KEY"
CLI
sales-engine lead-lists leads <id>

Response

A 200 with the result under data, on creation too. Errors come back as an error object with a stable code; see Errors.

Shape
{
  "data": { ... }
}

Run it below to see the live shape for your workspace.

Try it

Runs against this server, as the workspace behind the key.
Kept in this page while you browse the docs, gone on reload, never stored. Signed in to the app? Leave it blank and the call runs as you.
Path
required
The record's id.
Query
Search text.
Pipeline stage.
valid, catch_all, invalid, unknown.
Rows.
Offset.
Request
GET /api/v1/lead-lists/%7Bid%7D/leads
Fill the path first.

Also in Lead lists