Skip to main content
Poll this endpoint after a KYC/KYB submission to check the current verification status. When status is "approved" and is_va_approved is true, the customer can use payment services. 
GET /customer/kyc/{customer_id}

​
Path parameters

​
customer_id
string
required
The UUID of the customer whose verification status you want to check.

​
Status values

StatusDescription
not_startedNo KYC submission has been made yet
submittedSubmission received, awaiting review
manual_reviewUnder manual review by compliance team
approvedCustomer is fully verified
rejectedSubmission was rejected (see kyc_rejection_reasons)
under_reviewAdditional review in progress
When is_va_approved is true, the customer can use virtual accounts and payment services. Check both status === "approved" and is_va_approved === true before enabling payment features.
curl -X GET 'https://api.yativo.com/api/v1/customer/kyc/c586066b-0f29-468f-b775-15483871a202' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": {
    "first_name": "Alex",
    "last_name": "Smith",
    "status": "approved",
    "kyc_rejection_reasons": [],
    "kyc_requirements_due": [],
    "bio_data": {
      "customer_kyc_status": "approved",
      "kyc_verified_date": "2026-04-02T12:00:00.000000Z"
    },
    "kyc_link": "https://kyc.yativo.com/individual/c586066b-0f29-468f-b775-15483871a202",
    "is_va_approved": true
  }
}

{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": {
    "first_name": "Alex",
    "last_name": "Smith",
    "status": "submitted",
    "kyc_rejection_reasons": [],
    "kyc_requirements_due": [],
    "bio_data": {
      "customer_kyc_status": "submitted",
      "kyc_verified_date": null
    },
    "kyc_link": "https://kyc.yativo.com/individual/c586066b-0f29-468f-b775-15483871a202",
    "is_va_approved": false
  }
}

{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": {
    "first_name": "Alex",
    "last_name": "Smith",
    "status": "rejected",
    "kyc_rejection_reasons": [
      "Document image quality is too low",
      "Selfie does not match ID photo"
    ],
    "kyc_requirements_due": ["selfie_image", "identifying_information"],
    "bio_data": {
      "customer_kyc_status": "rejected",
      "kyc_verified_date": null
    },
    "kyc_link": "https://kyc.yativo.com/individual/c586066b-0f29-468f-b775-15483871a202",
    "is_va_approved": false
  }
}