Submit KYC application

POST

/v1/kyc/applications

Submits a KYC identity verification application. Required: name, nationality, document type/number, DOB (18+), document expiry (future date), address. Document types: passport, id_card, drivers_license. Returns 409 if an active application already exists.

Authentication: Bearer JWT (user session).

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

KYC submitted

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/kyc/applications' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "first_name": "string",
    "last_name": "string",
    "nationality": "string",
    "document_type": "passport",
    "document_number": "string",
    "date_of_birth": "2019-08-24",
    "document_expiry": "2019-08-24",
    "address": {
        "street": "string",
        "city": "string",
        "postal_code": "string",
        "country": "st"
    }
}'

Response Example

201 - Example 1

{
    "application_id": "48ac72d0-a829-4896-a067-dcb1c2b0f30c",
    "status": "string",
    "next_step": "string"
}

Modified at 2026-06-23 04:24:01

POST /v1/kyb/applications/{id}/documents/{document_id}/confirm

Get my KYC application