Buvei
API ReferenceKYC

Get KYC Cardholder

Retrieve the current status of a KYC cardholder.

GET/open-api/v1/kyc/cardholders/{id}

Returns the latest known status of a previously created KYC cardholder.

Polling is acceptable for low-volume integrations. The CARDHOLDER_KYC_STATUS webhook is the recommended way to react to status changes — it is real-time and avoids burning rate-limit budget.

Path parameters

idstringpathrequired

Cardholder ID returned by either KYC create endpoint, e.g. kyc_8f3a9c2b1d4e5f6a.

Response

idstring
firstNamestring

Present for MANUAL and FORM cardholders. For AUTO, populated after hosted verification completes.

lastNamestring

Same population rules as firstName.

kycStatusstring

PENDING, APPROVED, or REJECTED.

kycRejectReasonstring

Reason text when kycStatus is REJECTED; otherwise null.

cardCountinteger

Number of cards currently issued under this cardholder.

maxCardCountinteger

Maximum cards allowed per cardholder. Default 2.

gmtCreateinteger

Creation time in epoch milliseconds.

sourcestring

DIDIT (auto), MANUAL, or FORM.

KYC status values

StatusMeaning
PENDINGSubmitted; awaiting verification. Cards cannot be issued.
APPROVEDVerification passed. Cards may be issued.
REJECTEDVerification failed. See kycRejectReason. Re-submit to retry.
Response
{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "id": "kyc_8f3a9c2b1d4e5f6a",
    "firstName": "John",
    "lastName": "Doe",
    "kycStatus": "APPROVED",
    "kycRejectReason": null,
    "cardCount": 1,
    "maxCardCount": 2,
    "gmtCreate": 1640995200000,
    "source": "DIDIT"
  }
}

On this page

Path parameters
Response
KYC status values