Skip to main content
GET
Get lead list

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

The ID of the requested item

Example:

"019f7ffb-d8df-711c-9dd8-8c68b3f060df"

Response

The requested Lead List

A list used to store leads

id
string<uuid>
required
read-only

Unique identifier for the lead list

Example:

"019f7ffb-b61d-73bd-996c-e5671848a9bf"

organization_id
string<uuid>
required
read-only

Organization ID that owns this lead list

Example:

"019f7ffb-b61d-73bd-996c-e568e707cea3"

name
string
required

Name of the lead list

Example:

"My Lead List"

timestamp_created
string<date-time>
required
read-only

Timestamp when the lead list was created

Example:

"2026-07-20T14:43:50.429Z"

has_enrichment_task
null | boolean

Whether this list runs the enrichment process on every added lead or not

Example:

false

owned_by
null | string<uuid>

User ID of the owner of this lead list. Defaults to the user that created the list

Example:

"019f7ffb-b61d-73bd-996c-e5691ae24ba4"