Create an individual application

post

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

Creates a verification application for the given externalUserId and levelId.
The verification workflow starts asynchronously. The response contains creation details;
use GET /v1/individual/applications/{applicationId} to retrieve status and results.

When the workflow requires applicant data collection, link contains the browser entry URL.
Otherwise, link is omitted.

An existing active application returns 409 active_application_exists, even for the same level.
Concurrent creation returns 409 application_create_in_progress; retry with backoff.
Active applications are not automatically resumed. Avoid duplicate submissions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

externalUserId

string

required

length between 1 and 64

^[A-Za-z0-9_-]{1,64}$

User identifier in the caller system.

levelId

string

required

length ≥ 1

Active verification Level ID.

levelVersion

int64

Optional version of the selected Level.

globalSettingVersion

int64

Optional global settings version.

fixedInfo

object

Identity information supplied when creating an application.

inputInfo

object

Applicant interface preferences. Liveness mode is determined by the verification level.

link

object

Link options for workflows that require applicant data collection. Invalid JSON field types are rejected.

metadata

array of objects

String key/value pairs. Keys are trimmed and must be unique after trimming. Values are not trimmed. Empty input makes no metadata additions.

metadata

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

error.type	Meaning	Action
insufficient_balance	Account balance is insufficient.	Top up the account balance.
test_quota_exceeded	Account test quota is exceeded.	Contact your account manager.

200Application creation acknowledgment.

400Request validation failed. Possible causes: Missing required fields (externalUserId, levelId) Invalid field format (e.g. nationality not ISO 3166-1 alpha-3) levelId references a non-existent or inactive level

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

403Account is not authorized for this service.

409An active application exists (active_application_exists), or another creation is in progress (application_create_in_progress). Retry the latter with backoff.

500Unexpected server error.

503Service temporarily unavailable (e.g. distributed lock acquisition failed). Safe to retry.