---
title: "Get Onramp Verification Status"
method: POST
path: "/onramp/verification/status"
tags: ["onramp"]
---

# Get Onramp Verification Status

`POST /onramp/verification/status`

Retrieve normalized Stripe CryptoCustomer KYC and identity verification status after Link authentication or after KYC steps. The server exchanges or reuses the Link OAuth token and never returns it to the client.

## Headers

- `X-API-KEY` string, required

## Request body

- OnrampCustomerStatusRequest
  - `auth_intent_id` string, required — Stripe Link auth intent ID used by the embedded component authenticate() call
  - `crypto_customer_id` string, required — Crypto customer ID returned by the Stripe embedded component after Link authentication

## Response `200`

Crypto customer verification status

- OnrampCustomerStatusResponse
  - `crypto_customer_id` string, required
  - `kyc_required` boolean, required
  - `kyc_status` string
  - `kyc_current_tier` string
  - `kyc_region` string, nullable
  - `kyc_next_step` string
  - `identity_verification_required` boolean, required
  - `identity_verification_status` string
  - `kyc_tiers` CustomerTierStatus[]
    - `tier` string, required
    - `verification_status` string, required
    - `verification_errors` string[]
  - `provided_fields` string[]

## Other responses

- `401` — Unauthorized
- `422` — Invalid request body
- `500` — Failed to get Stripe crypto customer status

---

[API](https://skmtc.net/coinvoyage/apis/coinvoyage-api-v3.md) · [All operations](https://skmtc.net/coinvoyage/apis/coinvoyage-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinvoyage/coinvoyage-api-v3/revisions/f3a3056f2c83/schema)