Skip to main content
This schema describes objects returned by the Lead List endpoints.

A list used to store leads

id
string<uuid>
required
read-only

Unique identifier for the lead list

Example:

"01a1121d-fca6-77e8-9643-b34b1b3e82f5"

organization_id
string<uuid>
required
read-only

Organization ID that owns this lead list

Example:

"01a1121d-fca6-77e8-9643-b34c9d32eb62"

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-10-06T16:48:37.542Z"

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:

"01a1121d-fca6-77e8-9643-b34d0abd3c99"