v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-1770249709.0 KB
Customers

List customers

Lists or searches customers connected to your account. All supported query parameters are optional. If none are provided, the response will include all customers connected to your account. This endpoint supports advanced sorting and filtering options.

get/v1/customers

Query parameters

page_numberinteger

Page number for paginated results. Starts at 1.

Page number for paginated results. Starts at 1.

page_sizeinteger

Number of results per page. Maximum: 1000.

Number of results per page. Maximum: 1000.

sort_by'name' | 'created_at'
sort_order'asc' | 'desc'
created_fromstring date-time

Start date for filtering by created_at date.

Start date for filtering by created_at date.

created_tostring date-time

End date for filtering by created_at date.

End date for filtering by created_at date.

namestring

Filter customers by name (partial match).

Filter customers by name (partial match).

external_idstring

Filter by your system's external_id.

Filter by your system's external_id.

emailstring

Filter customers by email address.

Filter customers by email address.

statusCustomerStatusV1[]

Filter customers by their current status.

Filter customers by their current status.

search_textstring

General search term to filter customers.

General search term to filter customers.

typesCustomerTypeV1[]

Filter by customer type individual or business.

Filter by customer type individual or business.

Headers

Straddle-Account-Idstring uuid

For use by platforms to specify an account_id to set the scope of a request.

Request-Idstring

Optional client generated identifier to trace and debug a request.

Correlation-Idstring

Optional client generated identifier to trace and debug a series of requests.

Response

OK

response_type'object' | 'array' | 'error' | 'none' required

Indicates the structure of the returned content.

  • "object" means the data field contains a single JSON object.
  • "array" means the data field contains an array of objects.
  • "error" means the data field contains an error object with details of the issue.
  • "none" means no data is returned.