Verifications
Start Instant Verification
Starts instant KYC verification for an individual customer. The customer must currently have no KYC level and no other active KYC application. AML screening runs after submission; poll GET /v1/customers/{customer_uuid}/ for the outcome: kyc_level is set once the application is approved.
POST
/v1/customers/{customer_uuid}/verification/instant/Authorization
X-Api-Key
string required
API key generated in the Developers section of the Stablegate app. Send it in the
X-Api-Key header on every request; the partner API does not require request signing.Path parameters
customer_uuid
string<uuid> required
Request body
first_name
string required
Customer's legal first name
last_name
string required
Customer's legal last name
date_of_birth
string<date> required
Customer's date of birth, ISO 8601 format (YYYY-MM-DD)
Responses
Successful Response
uuid
string<uuid4> required
KYC application UUID
status
string required
KYC application statusOne of:
new, waiting, pending, approved, rejected, cancelledkyc_level_key
string required
Key of the KYC level the application was submitted for
Validation Error
trace_id
string required
error_code
string required
One of:
devapi_internal_error, devapi_request_validation_error, devapi_iban_parse_error, devapi_customer_close_error, devapi_bank_code_required_error, devapi_download_aol_error, devapi_not_found_error, devapi_bad_request_error, devapi_email_occupied_error, devapi_idempotency_invalid_key, devapi_idempotency_key_misuse, devapi_idempotency_request_in_progress, devapi_kyc_application_link_error, devapi_instant_verification_error, devapi_unauthorized_error, devapi_forbidden_error, devapi_method_not_allowed_error, devapi_service_unavailable_errormessage
string required
details
object[] required
loc
string | string[] required
msg
string required
type
string required
curl https://api.stablegate.com/v1/customers/CUSTOMER_UUID/verification/instant/ \
--request POST \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"first_name": "string",
"last_name": "string",
"date_of_birth": "2026-01-01"
}'
{
"uuid": "string",
"status": "new",
"kyc_level_key": "string"
}
{
"trace_id": "string",
"error_code": "devapi_internal_error",
"message": "string",
"details": [
{
"loc": "string",
"msg": "string",
"type": "string"
}
]
}