> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Customer KYC Status

> Poll the KYC verification status for a customer. Card wallet is deployed automatically when KYC is first approved.

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer YOUR_ACCESS_TOKEN`
</ParamField>

<ParamField path="yativoCardId" type="string" required>
  The customer's `yativo_card_id`.
</ParamField>

<Note>
  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.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  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'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Approved theme={null}
  {
    "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"
    }
  }
  ```

  ```json 200 Pending theme={null}
  {
    "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
    }
  }
  ```

  ```json 200 Rejected theme={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"
    }
  }
  ```
</ResponseExample>

### 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                          |