Skip to main content
GET
List a list's contacts

Authorizations

Authorization
string
header
required

An API key (utk_live_...) or an app's OAuth access token (uto_...).

Path Parameters

listId
string<uuid>
required

A contact list id.

Query Parameters

Part of the name or the address, at most 200 characters.

Maximum string length: 200
status
enum<string>

subscribed or unsubscribed; every contact when left out.

Available options:
subscribed,
unsubscribed
addedAfter
string<date-time>

Contacts added at or after this time (RFC 3339; UTC when no offset).

emails
string<email>[]

The contacts with exactly these addresses, case ignored: repeat the parameter or separate with commas, at most 100.

Maximum array length: 100
sort
string
default:added:desc

added (newest first by default), name or email, with :asc or :desc (name:asc). A field alone: added newest first, name and email A to Z.

Examples:

"added:desc"

"name:asc"

limit
integer
default:25

Items per page, 1 to 100 (default 25). Out of range is 400 PUB-001-001.

Required range: 1 <= x <= 100
cursor
string

The nextCursor of the previous page. Opaque: send it back as it came.

Response

A page of contacts.

A page of contacts.

data
object[]
required
nextCursor
string | null
required

Send it back as cursor for the next page; null on the last page.

Last modified on November 8, 2026