List customers
Returns a paginated list of customers for the authenticated project.
Returns a list envelope with ISO 8601 timestamps.
Supports cursor-based pagination via limit and starting_after.
Authorizations
Bearer authentication using the project Secret Key (prefixed with sk_), used exactly as shown in the dashboard. Endpoints that support sandbox data take an explicit environment field or parameter. All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.
Query Parameters
Maximum number of customers to return per page (1–100).
1 <= x <= 100Cursor for the next page: pass the next_cursor value from the previous response unchanged.
Field to sort results by.
Sort direction.
asc, desc Filter by environment: 0 = sandbox, 1 = production.
0, 1 Search query string.
Filter by customer status. Repeatable: filter[status][]=active&filter[status][]=churned.
Filter by target platform. Repeatable.
Response
A paginated list of customers.
list "/v4/customers"
true when more customers are available after this page.
Opaque cursor for the next page. Present only when has_more is true; pass it unchanged as starting_after to fetch the next page.
"Y3VzdDoy"