KYC simple status

curl --request GET \
  --url https://api.example.com/api/v1/auth/kyc/simple-status

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/auth/kyc/simple-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

GET

api

auth

kyc

simple-status

KYC simple status

curl --request GET \
  --url https://api.example.com/api/v1/auth/kyc/simple-status

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/auth/kyc/simple-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

No authentication required — this endpoint is publicly accessible and never returns an error.

Returns a single status string for the user’s KYC verification. This endpoint never returns an HTTP error — it always answers 200:

If the user has never started KYC, it returns not_started.
If anything unexpected happens, it returns error.

Use this for lightweight checks where a full KYC status response is overkill.

Request

GET /api/v1/auth/kyc/simple-status

No body or query parameters.

Response

200 OK — always.

{
  "success": true,
  "data": {
    "status": "approved"
  }
}

Field	Type	Description
`data.status`	string	One of: `not_started`, `created`, `pending`, `in_progress`, `completed`, `expired`, `failed`, `needs_review`, `approved`, `declined`, `rejected`, `error`

Errors

This endpoint never returns a non-200 HTTP status.

Exchange rates / TRM

Cards

Users

Login

User profile

KYC

Account Management

Financials

KYC simple status

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors