Skip to main content
GET
Get one list

Authorizations

Authorization
string
header
required

API key from Settings → API. Send it as Authorization: Bearer .

Headers

x-impersonate-user-id
string

ID of an organization member to act on behalf of. The API key user must be the owner of the organization and the target user must belong to the same organization.

Path Parameters

id
number
required

Response

200 - application/json

Get one list with contacts

id
number
required

Unique identifier for the list

name
string
required

Name of the list

userId
number
required

User ID who owns this list

user
object
required

Associated user account

createdAt
string<date-time>
required

Creation timestamp

updatedAt
string<date-time>
required

Last update timestamp

campaignId
number

Campaign ID associated with this list

campaign
object

Associated campaign

customFields
string[]

Custom field definitions imported into this list (append-only union across imports)