GET
/
v1
/
customers

Authorizations

Authorization
string
header
required

Use your Straddle API Key in the Authorization header as Bearer <token> to authorize API requests.

Headers

Straddle-Account-Id
string

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

Request-Id
string

Optional client generated identifier to trace and debug a request.

Correlation-Id
string

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

Query Parameters

page_number
integer
default:
1

Page number for paginated results. Starts at 1.

page_size
integer
default:
100

Number of results per page. Maximum: 1000.

sort_by
enum<string>
Available options:
name,
created_at
sort_order
enum<string>
default:
asc
Available options:
asc,
desc
created_from
string

Start date for filtering by created_at date.

created_to
string

End date for filtering by created_at date.

name
string

Filter customers by name (partial match).

external_id
string

Filter by your system's external_id.

email
string

Filter customers by email address.

status
enum<string>[]

Filter customers by their current status.

Available options:
pending,
review,
verified,
inactive,
rejected
search_text
string

General search term to filter customers.

types
enum<string>[]

Filter by customer type individual or business.

Available options:
individual,
business

Response

200 - text/plain
data
object[]
required
meta
object
required
response_type
enum<string>
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.
Available options:
object,
array,
error,
none