Skip to main content
POST
Required scopes: customers:ro

Authorizations

​
Authorization
string
header
required

Use your account ID as the username and your personal access token (PAT) as the password, or pass a Base64-encoded value directly in the Authorization header. For more information, see the personal access tokens guide.

Body

application/json
​
query
string

A free-text search query across name, email, and phone_number fields. Automatically excludes fields that are explicitly filtered.

Minimum string length: 3
Example:

"john smith"

​
filters
object[]

An array of filter groups combined with AND logic.

​
results_per_page
integer
default:50

The number of results to return per page.

Required range: 1 <= x <= 100
​
sort
object

The sorting configuration (field -> order mapping). Multiple sort fields can be specified. Note: created_at is always appended as the final sort field to ensure stable pagination.

Example:
​
page_id
string

The page identifier for pagination. Should be a numeric string starting from "1". Use the next_page_id from the previous response to navigate to the next page.

Example:

"1"

Response

A list of customers matching the search criteria.

​
customers
object[]
required

An array of customer objects matching the search criteria.

​
total
integer<int32>
required

The total number of customers matching the search criteria.

Example:

1523

​
page_id
string
required

The current page identifier.

Example:

"1"

​
next_page_id
string

The page identifier for the next page of results. Empty string if there are no more pages. Pass this value as page_id in the next request to retrieve the next page.

Example:

"2"