Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Body

application/json
limit
number
default:50

Maximum number of contacts to return.

Required range: 1 <= x <= 1000
skip
number
default:0

Number of records to skip for offset-based pagination.

Required range: x >= 0
sort_order
enum<string>
default:desc

Sort contacts by last_conversation_timestamp in ascending or descending order. Contacts that have never been contacted sort as if their timestamp were 0.

Available options:
asc,
desc
pagination_key
string

Base64url-encoded pagination key from a previous response.

filter_criteria
object

Filter criteria for contacts. All conditions are implicitly connected with AND. first_name and last_name are not filterable here; use search_query to match on those.

search_query
string

Case-insensitive substring match against phone number, first name, last name, external ID, and custom field values. This is the only way to match on a contact's name.

Response

Paginated list of contacts.

items
object[]
pagination_key
string

Base64url-encoded pagination key for the next page.

has_more
boolean
total
number

Total count of contacts matching the filter.