Skip to main content
GET
/
v1
/
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"
  }
}
​
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"
  }
}

​
KYC Status Values

StatusMeaning
pendingNot yet started, documents requested, or awaiting submission
in_progressDocuments submitted — under active review
pending_reviewResubmission requested — customer must supply additional or corrected documents
approvedIdentity verified — proceed to source of funds
rejectedVerification failed — customer must restart onboarding