Check Customer KYC Status

curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/kyc-status' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "approved",
    "verification_level": "STANDARD",
    "terms_accepted": true,
    "next_step": "source_of_funds"
  }
}

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "pending",
    "verification_level": null,
    "terms_accepted": false,
    "next_step": null
  }
}

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "rejected",
    "rejection_reason": "Document not accepted",
    "next_step": "retry_kyc"
  }
}

GET

yativo-card

customers

{yativoCardId}

kyc-status

curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/kyc-status' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "approved",
    "verification_level": "STANDARD",
    "terms_accepted": true,
    "next_step": "source_of_funds"
  }
}

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "pending",
    "verification_level": null,
    "terms_accepted": false,
    "next_step": null
  }
}

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "rejected",
    "rejection_reason": "Document not accepted",
    "next_step": "retry_kyc"
  }
}

Authorization

string

required

Bearer token: Bearer YOUR_ACCESS_TOKEN

yativoCardId

string

required

The customer’s yativo_card_id.

When KYC status first changes to approved, Yativo automatically provisions the customer’s card wallet in the background (typically completes within 60 seconds). You do not need to call a separate wallet deployment endpoint. Once kyc_status is approved, proceed directly to Source of Funds questions.

curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/kyc-status' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "approved",
    "verification_level": "STANDARD",
    "terms_accepted": true,
    "next_step": "source_of_funds"
  }
}

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "pending",
    "verification_level": null,
    "terms_accepted": false,
    "next_step": null
  }
}

{
  "success": true,
  "message": "KYC status retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_status": "rejected",
    "rejection_reason": "Document not accepted",
    "next_step": "retry_kyc"
  }
}

KYC Status Values

Status	Meaning
`pending`	Not yet started, documents requested, or awaiting submission
`in_progress`	Documents submitted — under active review
`pending_review`	Resubmission requested — customer must supply additional or corrected documents
`approved`	Identity verified — proceed to source of funds
`rejected`	Verification failed — customer must restart onboarding

Create Card Customer Get Customer KYC Link

​KYC Status Values

KYC Status Values