contacts

List Contact Lists

List the contact lists in the workspace.

Requires the contact_lists:read scope on the API key.

get/v1/contact-lists

Query parameters

pageinteger

Page number.

sizeinteger

Number of items per page.

sort_by'created_at' | 'updated_at' | 'name'

Field to sort by.

sort_order'asc' | 'desc'

Sort direction.

namestring nullable

Filter by list name (exact match).

created_at_beforestring date-time nullable

Return lists created strictly before this timestamp.

created_at_afterstring date-time nullable

Return lists created strictly after this timestamp.

Successful Response

total_countinteger required

Total number of records matching the query.

total_pagesinteger required

Total number of pages.

has_moreboolean required

Whether more pages remain after the current one.

Changed in 1 of the 12 revisions of this API.1

Aug 4, 2026467ce2bf692b1See the full diff
- ○
  added the optional property items/items/default_sequence_template to the response with the 200 status
  response-optional-property-added