Approve an application
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Responses
Section titled “ Responses ”Application details
object
Business application details (present for business type applications)
object
Example
Acme CorporationExample
507f1f77bcf86cd799439011Example
2026-03-01T10:00:00.000ZExample
2026-03-30T12:00:00.000ZWhether this is a manual application
Display-facing account classification for the Overview meta-field. “entity” = business application; “joint” = individual application linked to a second individual via a JOINT_ACCOUNT entity link; “individual” = single personal application.
When the application entered its current stage. Drives the “pending for N days” meta-field for non-approved applications. Null for legacy rows created before stage tracking — callers fall back to createdAt.
Example
2026-03-20T09:00:00.000Zobject
Document ID
Example
507f1f77bcf86cd799439011Example
John SmithExample
2026-03-30T12:00:00.000ZExample
https://storage.example.com/signatures/signed-agreement.pdfWhether the signature document is hidden
Example
SUBMITTEDArbitrary key-value metadata attached to the application. Null when no metadata is set.
object
Example
{ "externalRef": "abc-123", "plan": "enterprise"}object
Example
companyNameExample
companies-houseExample
trueExample
Company name matches registrar recordsExample
2026-03-30T12:00:00.000Zobject
Example
60d5ecb54b24003a7c8e92b2Example
auth0|507f1f77bcf86cd799439011Example
JohnExample
SmithExample
john.smith@example.comExample
Compliance OfficerExample
2026-03-30T12:00:00.000ZExample
2026-03-30T12:00:00.000Zobject
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.
Example
45Per-factor breakdown. Each entry is one risk factor and its contribution to the overall score.
object
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.
Example
JurisdictionThis factor’s contribution to the overall risk score.
Example
30Qualitative 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.
Example
mediumHuman-readable title for this risk factor.
Example
Jurisdiction Riskobject
Example
507f1f77bcf86cd799439011Join row id (business_individuals.id or business_companies.id) — used for unlink/edit operations
Example
507f1f77bcf86cd799439099Example
507f1f77bcf86cd799439012Example
SUBMITTEDExample
trueobject
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBExample
JohnExample
DavidExample
SmithExample
45Which screening types to include
object
Label IDs assigned to this application
Example
[ "507f1f77bcf86cd799439011"]object
Example
75Example
DOCUMENT_UPLOADExample
Document UploadExample
60d5ecb54b24003a7c8e92a1object
object
object
object
Example
12345678Example
GB123456789Example
BUSINESSobject
Example
FCAExample
123456ISO 3166-1 alpha-2 country code
Example
GBExample
2020-01-15Example
2020-01-15Example
2020-01-15Example
Discretionary TrustExample
Limited CompanyExample
Investment management and advisory servicesExample
Financial servicesExample
Financial ServicesExample
Investment Managementobject
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBobject
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBobject
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBobject
Example
+1Example
4143319681Example
https://www.acmecorp.comExample
64110Example
GB123456789Example
A02951077Example
Partner BankExample
Referred by relationship managerExample
1000000-5000000Example
500000-1000000Example
50Example
100000-500000Example
[ "GBP", "EUR", "USD"]Example
[ "GB", "DE", "US"]Example
[ "GB", "FR"]Example
Supplier paymentsExample
Revenue from operationsExample
250000Example
GBPExample
2026-03-30T12:00:00.000ZExample
trueExample
Limited CompanyExample
FCAExample
123456ID of the parent business application that spawned this business application as a related corporate party (e.g. corporate UBO, holding company). Absent when the business application is a standalone primary onboarding.
Example
507f1f77bcf86cd799439011Roles this business holds in the parent business application. Only present when parentApplicationId is set.
Example
[ "UBO", "SHAREHOLDER"]object
Example
{ "hiddenFields": [ "businessActivity" ], "hiddenSections": [ "step-1" ]}object
Example
507f1f77bcf86cd799439011Which screening types to include
object
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBExample
JohnExample
DavidExample
SmithExample
1990-05-15Example
1990Example
5Example
2Example
No matches confirmed after reviewISO 3166-1 alpha-2 country code
Example
GBIndividual application details (present for individual type applications)
object
Example
Acme CorporationExample
507f1f77bcf86cd799439011Example
2026-03-01T10:00:00.000ZExample
2026-03-30T12:00:00.000ZWhether this is a manual application
Display-facing account classification for the Overview meta-field. “entity” = business application; “joint” = individual application linked to a second individual via a JOINT_ACCOUNT entity link; “individual” = single personal application.
When the application entered its current stage. Drives the “pending for N days” meta-field for non-approved applications. Null for legacy rows created before stage tracking — callers fall back to createdAt.
Example
2026-03-20T09:00:00.000Zobject
Document ID
Example
507f1f77bcf86cd799439011Example
John SmithExample
2026-03-30T12:00:00.000ZExample
https://storage.example.com/signatures/signed-agreement.pdfWhether the signature document is hidden
Example
SUBMITTEDArbitrary key-value metadata attached to the application. Null when no metadata is set.
object
Example
{ "externalRef": "abc-123", "plan": "enterprise"}object
Example
companyNameExample
companies-houseExample
trueExample
Company name matches registrar recordsExample
2026-03-30T12:00:00.000Zobject
Example
60d5ecb54b24003a7c8e92b2Example
auth0|507f1f77bcf86cd799439011Example
JohnExample
SmithExample
john.smith@example.comExample
Compliance OfficerExample
2026-03-30T12:00:00.000ZExample
2026-03-30T12:00:00.000Zobject
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.
Example
45Per-factor breakdown. Each entry is one risk factor and its contribution to the overall score.
object
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.
Example
JurisdictionThis factor’s contribution to the overall risk score.
Example
30Qualitative 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.
Example
mediumHuman-readable title for this risk factor.
Example
Jurisdiction Riskobject
Example
507f1f77bcf86cd799439011Join row id (business_individuals.id or business_companies.id) — used for unlink/edit operations
Example
507f1f77bcf86cd799439099Example
507f1f77bcf86cd799439012Example
SUBMITTEDExample
trueobject
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBExample
JohnExample
DavidExample
SmithExample
45Which screening types to include
object
Label IDs assigned to this application
Example
[ "507f1f77bcf86cd799439011"]object
Example
75Example
DOCUMENT_UPLOADExample
Document UploadExample
60d5ecb54b24003a7c8e92a1object
object
object
Example
JohnExample
DavidExample
SmithExample
1990-05-15Example
1990Example
5ISO 3166-1 alpha-2 country code
Example
GBISO 3166-1 alpha-2 country code
Example
GBobject
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBobject
Example
+1Example
4143319681ISO 3166-1 alpha-2 country code
Example
IEISO 3166-1 alpha-2 country code
Example
GBISO 3166-1 alpha-2 country code
Example
IEExample
AB123456CExample
john.smith@example.comExample
50000Example
GBPExample
trueExample
EMPLOYEDExample
Software Engineerobject
object
Example
507f1f77bcf86cd799439011Which screening types to include
object
Example
123 Main StreetExample
Apt 4BExample
LondonExample
EnglandExample
GBExample
EC1A 1BBExample
JohnExample
DavidExample
SmithExample
1990-05-15Example
1990Example
5Example
2Example
No matches confirmed after reviewISO 3166-1 alpha-2 country code
Example
GBExample
50000-100000Example
100000-500000Example
20Example
10000-50000Example
[ "GBP", "EUR"]Example
[ "GB", "DE"]Example
[ "GB", "US"]Example
Personal expensesExample
SalaryID of the parent business application that spawned this individual application as a key person (e.g. UBO, director, shareholder). Absent when the individual application is a standalone primary onboarding.
Example
507f1f77bcf86cd799439011Roles this individual holds in the parent business application. Only present when parentApplicationId is set.
Example
[ "UBO", "DIRECTOR"]object
Example
{ "hiddenFields": [ "phoneNumber" ], "hiddenSections": [ "step-1" ]}The submitter (person filling out the application) — name and email
object
Example
MichaelExample
ChenExample
michael.chen@acme-corp.comExample
{ "businessApplication": { "name": "Acme Corporation", "id": "507f1f77bcf86cd799439011", "createdAt": "2026-03-01T10:00:00.000Z", "updatedAt": "2026-03-30T12:00:00.000Z", "verified": false, "manual": false, "customerType": {}, "accountType": {}, "stageEnteredAt": "2026-03-20T09:00:00.000Z", "status": "SUBMITTED", "metadata": { "externalRef": "abc-123", "plan": "enterprise" }, "verifications": [], "reviewers": [], "keyPeople": [], "labelIds": [ "507f1f77bcf86cd799439011" ], "skip2FA": false, "accountId": "60d5ecb54b24003a7c8e92a1", "unmappedResponses": [], "registrationNumber": "12345678", "taxIdentificationNumber": "GB123456789", "entityType": "BUSINESS", "jurisdiction": "GB", "incorporationDate": "2020-01-15", "establishmentDate": "2020-01-15", "registrationDate": "2020-01-15", "trustType": "Discretionary Trust", "legalForm": "Limited Company", "purpose": "Investment management and advisory services", "businessActivity": "Financial services", "industry": "Financial Services", "subIndustry": "Investment Management", "website": "https://www.acmecorp.com", "sicCode": "64110", "vatNumber": "GB123456789", "taxId": "A02951077", "referrer": "Partner Bank", "referrerNote": "Referred by relationship manager", "companyTurnover": "1000000-5000000", "annualFlow": "500000-1000000", "estimatedNumberOfPayments": 50, "expectedFxRequirement": "100000-500000", "currenciesRequired": [ "GBP", "EUR", "USD" ], "countriesSentTo": [ "GB", "DE", "US" ], "countriesReceivedFrom": [ "GB", "FR" ], "paymentPurpose": "Supplier payments", "fundingSource": "Revenue from operations", "investmentAmount": 250000, "investmentAmountCurrency": "GBP", "refreshedAt": "2026-03-30T12:00:00.000Z", "isAudited": true, "hasPep": false, "ownershipLayers": 1, "legalEntityType": "Limited Company", "regulatoryAuthority": "FCA", "regulatoryNumber": "123456", "parentApplicationId": "507f1f77bcf86cd799439011", "parentRoles": [ "UBO", "SHAREHOLDER" ], "displayConfiguration": { "hiddenFields": [ "businessActivity" ], "hiddenSections": [ "step-1" ] }, "screening": [] }, "individualApplication": { "name": "Acme Corporation", "id": "507f1f77bcf86cd799439011", "createdAt": "2026-03-01T10:00:00.000Z", "updatedAt": "2026-03-30T12:00:00.000Z", "verified": false, "manual": false, "customerType": {}, "accountType": {}, "stageEnteredAt": "2026-03-20T09:00:00.000Z", "status": "SUBMITTED", "metadata": { "externalRef": "abc-123", "plan": "enterprise" }, "verifications": [], "reviewers": [], "keyPeople": [], "labelIds": [ "507f1f77bcf86cd799439011" ], "skip2FA": false, "accountId": "60d5ecb54b24003a7c8e92a1", "unmappedResponses": [], "firstName": "John", "middleName": "David", "lastName": "Smith", "dateOfBirth": "1990-05-15", "yearOfBirth": 1990, "monthOfBirth": 5, "countryOfBirth": "GB", "nationality": "GB", "otherNationality": "IE", "taxResidency": "GB", "secondaryTaxResidency": "IE", "taxIdentificationNumber": "AB123456C", "email": "john.smith@example.com", "amountToBeInvested": 50000, "amountToBeInvestedCurrency": "GBP", "usCitizen": false, "isPEP": false, "roles": [], "onboarding": true, "employmentStatus": "EMPLOYED", "occupation": "Software Engineer", "stewardProfile": false, "screening": [], "accountTurnover": "50000-100000", "annualFlow": "100000-500000", "estimatedNumberOfPayments": 20, "expectedFxRequirement": "10000-50000", "currenciesRequired": [ "GBP", "EUR" ], "countriesSentTo": [ "GB", "DE" ], "countriesReceivedFrom": [ "GB", "US" ], "paymentPurpose": "Personal expenses", "fundingSource": "Salary", "parentApplicationId": "507f1f77bcf86cd799439011", "parentRoles": [ "UBO", "DIRECTOR" ], "displayConfiguration": { "hiddenFields": [ "phoneNumber" ], "hiddenSections": [ "step-1" ] } }, "submitter": { "firstName": "Michael", "lastName": "Chen", "email": "michael.chen@acme-corp.com" }}