Skip to content
Back to Steward

List applications

GET
/api/v1/applications
status
Array<string>
Allowed values: PENDING SUBMITTED APPROVED REJECTED

Filter by application status

types
Array<string>
Allowed values: live manual hidden

Filter by application view type (Live = all non-manual/hidden, Manual = manual applications, Hidden = hidden applications)

entityTypes
Array<string>
Allowed values: BUSINESS INDIVIDUAL

Filter by multiple entity types (BUSINESS or INDIVIDUAL)

accountId
string
Example
507f1f77bcf86cd799439011

Filter by account ID

manual
boolean

Filter by manual flag

hidden
boolean

Filter by hidden flag

createdFrom
string
Example
2024-01-01T00:00:00.000Z

Filter by creation date (from)

createdTo
string
Example
2024-12-31T23:59:59.999Z

Filter by creation date (to)

riskScoreMin
number
0

Filter by minimum risk score

riskScoreMax
number
Example
100

Filter by maximum risk score

riskLevels
Array<string>
Allowed values: PROHIBITED HIGH MEDIUM LOW

Filter by risk levels (LOW, MEDIUM, HIGH, PROHIBITED). Takes precedence over riskScoreMin/riskScoreMax if provided.

assignees
Array<string>

Filter by assignee user IDs

search
string
Example
john

Search keyword for application name, email, or account name

labelIds
Array<string>

Filter by label IDs

cursor
string
Example
ZGVzY3x1cGRhdGVkQXR8MjAyNi0wNS0xM1QxNjowOToxMi4wMDBafDUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMQ

Opaque cursor from a previous response’s nextCursor. Omit on the first page. Cursors are tied to a sort direction — changing order mid-pagination is rejected.

limit
number
default: 50 >= 1 <= 100

Items per page (1-100). Default 50.

order
string
default: desc
Allowed values: asc desc

Sort direction (with id as tiebreaker). Default desc (newest first). The column being sorted is endpoint-specific — see the individual endpoint docs.

orderBy
string
default: updatedAt
Allowed values: createdAt updatedAt

Sort field. createdAt orders by when the application was created; updatedAt orders by most recent activity. Default updatedAt.

Returns paginated applications response

object
items
required
Array<object>
object
name
required
string
Example
Acme Corporation
id
required
string
Example
507f1f77bcf86cd799439011
createdAt
required
string format: date-time
Example
2026-03-01T10:00:00.000Z
updatedAt
required
string format: date-time
Example
2026-03-30T12:00:00.000Z
manual
required

Whether this is a manual application

boolean
customerType
required
string
Allowed values: BUSINESS INDIVIDUAL
status
string
Example
SUBMITTED
reviewers
required
Array<object>
object
id
required
string
Example
60d5ecb54b24003a7c8e92b2
externalId
required
string
Example
auth0|507f1f77bcf86cd799439011
firstName
required
string
Example
John
lastName
required
string
Example
Smith
email
required
string
Example
john.smith@example.com
title
required
string
Example
Compliance Officer
createdAt
required
string format: date-time
Example
2026-03-30T12:00:00.000Z
updatedAt
required
string format: date-time
Example
2026-03-30T12:00:00.000Z
risk
object
score
required

Overall numeric risk score for the application. The band (LOW / MEDIUM / HIGH / PROHIBITED) is not stored — it is derived from this number using the account risk scoring strategy. See the Risk Scoring guide for the strategy-specific bands.

number
Example
45
data

Per-factor breakdown. Each entry is one risk factor and its contribution to the overall score.

Array<object>
object
category
required

Identifier for this risk factor. The available factors depend on the account risk scoring strategy, so this is an open string (e.g. “Jurisdiction”, “Country Risk”, “PEP”), not a fixed enum.

string
Example
Jurisdiction
score
required

This factor’s contribution to the overall risk score.

number
Example
30
level
required

Qualitative level for this factor: low, medium, high, prohibited, or bonus (a risk-reducing factor, e.g. a regulated entity). Lowercase — distinct from the uppercase overall risk band derived from RiskData.score.

string
Example
medium
title
required

Human-readable title for this risk factor.

string
Example
Jurisdiction Risk
keyPeople
Array<object>
object
id
required
string
Example
507f1f77bcf86cd799439011
joinId

Join row id (business_individuals.id or business_companies.id) — used for unlink/edit operations

string
Example
507f1f77bcf86cd799439099
type
required
string
Allowed values: individual business
applicationId
required
string
Example
507f1f77bcf86cd799439012
status
required
string
Example
SUBMITTED
stewardProfile
boolean
Example
true
address
object
street
string
Example
123 Main Street
apartment
string
Example
Apt 4B
city
string
Example
London
state
string
Example
England
country
string
Example
GB
postalCode
string
Example
EC1A 1BB
firstName
required
string
Example
John
middleName
string
Example
David
lastName
required
string
Example
Smith
roles
required
Array<string>
Allowed values: DIRECTOR SHAREHOLDER UBO GENERAL_PARTNER LIMITED_PARTNER INVESTMENT_MANAGER FOUNDER COUNCIL_MEMBER TRUSTEE SETTLOR BENEFICIARY PROTECTOR INTERMEDIARY CONTROLLING_PERSON AUTHORIZED_SIGNATORY RELATED_PARTY PARENT PLAN_SPONSOR SENIOR_MANAGING_OFFICIAL EXECUTOR_ADMINISTRATOR DECEASED_PERSON JOINT_ACCOUNT MANAGER SIGNER
riskScore
number
Example
45
screeningSummary
required

Which screening types to include

Array<string>
Allowed values: ADVERSE_MEDIA SANCTIONS WARNING PEP
labelIds

Label IDs assigned to this application

Array<string>
Example
[
"507f1f77bcf86cd799439011"
]
childApplications
Array<object> recursive
openTasksCount

Count of open tasks for this application

number
Example
3
nextCursor
required
string
nullable
Example
ZGVzY3x1cGRhdGVkQXR8MjAyNi0wNS0xM1QxNjowOToxMi4wMDBafDUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMQ
Example
{
"items": [
{
"name": "Acme Corporation",
"id": "507f1f77bcf86cd799439011",
"createdAt": "2026-03-01T10:00:00.000Z",
"updatedAt": "2026-03-30T12:00:00.000Z",
"manual": false,
"customerType": {},
"status": "SUBMITTED",
"reviewers": [],
"keyPeople": [],
"labelIds": [
"507f1f77bcf86cd799439011"
],
"childApplications": [],
"openTasksCount": 3
}
],
"nextCursor": "ZGVzY3x1cGRhdGVkQXR8MjAyNi0wNS0xM1QxNjowOToxMi4wMDBafDUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMQ"
}