Verifications
Get Customer Verification
Returns the latest KYC application of the customer and the level the customer holds. The status shows whether compliance waits for the customer, for us, or has finished, and `message` carries what compliance asked the customer for.
GET
/v1/customers/{customer_uuid}/verification/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
Responses
Successful Response
kyc_level_key
string | null
Current KYC level of the customer. Null until an application is approved
application
object | null
The latest KYC application of the customer, null when the customer never started verification
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
message
string | null
What compliance asked the customer for. Null when there is nothing to pass on
created_at
string<date-time> required
When the application was created
updated_at
string<date-time> required
When the application was last changed
last_status_change_at
string<date-time> required
When the status last changed
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/ \
--header 'X-Api-Key: YOUR_API_KEY'
{
"kyc_level_key": "string",
"application": {
"uuid": "string",
"status": "new",
"kyc_level_key": "string",
"message": "string",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"last_status_change_at": "2026-01-01T00:00:00Z"
}
}
{
"trace_id": "string",
"error_code": "devapi_internal_error",
"message": "string",
"details": [
{
"loc": "string",
"msg": "string",
"type": "string"
}
]
}