Check KYC status

The following API provides KYC status of a customer.

Retrieves the details of a Know Your Customer (KYC) application for a specified customer.

get

Retrieves the details of a Know Your Customer (KYC) application for a specified customer. This includes the KYC status, any missing documents, and details about any issues or rejections in the KYC process.

Access to this endpoint requires a valid API key. The API key is sent in the x-api-key header on requests.

Status values:

  • null - No customer or customer profile exists yet. Customer needs to be created and have an profile.

  • "CREATED" - Customer exists, but KYC applicant has not been created yet.

  • Other values - KYC process is in progress or completed (e.g., "FULL_USER", "SOFT_KYC_FAILED", etc.).

Authorizations
Path parameters
idstringRequired
  • The external identifier for the customer for whom to retrieve KYC details.
Responses
200

Ok

application/json
get
/customer/{id}/bank-transfer/kyc
GET /api/v2/customer/{id}/bank-transfer/kyc HTTP/1.1
Host: api.xgateway.tech
x-api-key: YOUR_API_KEY
Accept: */*
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "status": null
  },
  "success": true
}

Last updated