Submit Application

post

https://openapi.advance.ai/v1/business/applications

Submits a KYB application. Choose a submission mode via mode:

STRUCTURED (default) — provide a nested structured payload with
companyInfo, declaredCompanies, and declaredIndividuals.
FORM — provide a nested form payload with subjectQuestions and
optional associatedProfiles. qnreIdentifierVersion is required in FORM mode.

Replaces the former separate /form and /structured endpoints.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Unified KYB application submission request.
Use mode=STRUCTURED (default) with a structured payload, or mode=FORM
with a form payload (qnreIdentifierVersion required for FORM).

mode

string

enum

required

Application submission mode.

Allowed:

externalCompanyId

string

External company ID defined by the client.

kybLevel

string

required

The KYB verification level for this application.

applicantEmail

string

Email of the applicant. Must be a valid email format.

qnreIdentifierVersion

string

Bundled questionnaire identifier + version (e.g. KYBQ-123_v2).
Required when mode is FORM; optional for STRUCTURED.

applicationId

string

Optional client-supplied application identifier.

form

object

structured

object

Headers

X-Request-Id

string

Unique request identifier. Injected by the API gateway if not provided by the client.
The same value is available in the response body requestId field for business-layer tracing.

X-Trace-Id

string

Distributed tracing identifier. Injected by the API gateway if not provided by the client.
Used for cross-service request correlation in logs and monitoring.

Responses

200KYB application created successfully.

400Request validation failed or malformed JSON.

401Authentication failed. Access token is missing, invalid, or expired.

403Authentication succeeded but access is denied.

429Rate limit exceeded.

500Unexpected server error.