Subscription status: subscribed, unsubscribed, or pending (awaiting double opt-in confirmation).
created_at
Date and time the contact was created.
Example response
{
"pagination": {
"page": 1,
"page_size": 25,
"total_count": 150,
"total_pages": 6
},
"contacts": [
{
"id": 4821,
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe",
"status": "subscribed",
"created_at": "2026-05-21T09:45:00Z",
"plan": "pro"
}
]
}
In the example above, plan is a custom field defined on the list.
Query parameters
Param name
Possible values
Description
page
Integer
1-based page number. Default 1.
page_size
Integer
Number of contacts per page. Default 25.
search
String
Keyword search across the list’s text fields.
ordering
asc, desc
Sort direction. Default desc.
order_by
String
Field to sort by — email, created_at, or any of the list’s custom fields (see Get contact list for the available column_name values). Default created_at; an unknown value falls back to created_at.
