GET
Search applications and customers

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

programId
string
required

The program to scope results to. Required on every request — including when you pass allPrograms=true. A request without it is rejected before it reaches the search.

allPrograms
enum<string>

When true, widen the search from the single programId to every program your operator role is entitled to. It never reaches beyond your entitlements, and it does not remove the need to send programId. A role with no program entitlement matches nothing rather than everything.

Available options:
true,
false
customerId
string

Filter by customer ID. Comma-separated for multi-select.

custodianId
string

Filter by custodian ID. Comma-separated for multi-select. Ignored for guardian-bound roles, which are always scoped to their own guardian.

keyword
string

Free-text search across indexed fields.

fromDate
string<date-time>

Lower bound (inclusive) on record date, ISO 8601.

toDate
string<date-time>

Upper bound (inclusive) on record date, ISO 8601.

page
integer
default:1

1-based page number. Defaults to 1.

Required range: x >= 1
limit
integer

Maximum number of items per page.

Required range: x >= 1
sortBy
string

Field to sort results by.

sortOrder
enum<string>

Sort direction.

Available options:
asc,
desc
resultType
enum<string>
default:json

Result format. json (default) returns inline results; file returns a presigned S3 CSV URL (valid 1 hour) in place of the data array.

Available options:
json,
file
filePrefix
string

Customises the filename of the exported CSV when resultType=file.

applicationId
string

Filter by application ID. Comma-separated for multi-select.

isCompany
enum<string>

Filter to company (true) or individual (false) applications. Any other value is ignored rather than rejected.

Available options:
true,
false
workflowStage
string

Onboarding workflow stage to match, e.g. CUSTOMER. Comma-separated for multi-select.

workflowStageExclude
enum<string>

When true, the workflowStage filter is inverted (match everything except the given stage). Used to separate in-flight applications from completed customers.

Available options:
true,
false
isRisk
enum<string>

When true, returns results in the risk-report format (risk/compliance-oriented columns).

Available options:
true,
false
clientReference
string

Filter by the program's client reference.

skipCustomerType
string

Exclude records of this customer type from the results.

skipKycLastEvent
string

Exclude records whose most recent KYC event matches this value.

Response

Matching applications, or a presigned export URL when resultType=file.

Inline JSON results, or — when resultType=file — a presigned CSV export URL.

success
boolean
Example:

true

data
object[]
total
integer

Total number of matching records across all pages.

Example:

42

page
integer

The 1-based page returned.

Example:

1

limit
integer

Page size used for this response.

Example:

10