Skip to main content
GET
Get a contact list's metadata

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Path Parameters

listId
string<uuid>
required

Response

The contact list.

listId
string<uuid>
organizationId
string<uuid>
projectId
string<uuid>
name
string
sourceKind
enum<string>
Available options:
csv_upload,
paste,
google_sheets,
customer_api
sourceRef
string

Present only when the import supplied an uploadId or a sheet ref — inline rows have none, even when labelled csv_upload.

summary
object

What the import kept and dropped.

contactCount
integer

Contacts stored — the same number as summary.willBeCalled.

createdAt
string<date-time>
updatedAt
string<date-time>

Equal to createdAt, since a list is never edited.

version
integer

Always 1.