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

# Get Onramp Verification Status

`POST /onramp/verification/status`

## Request

- Base URL: `https://api.coinvoyage.io/v3`
- URL: `https://api.coinvoyage.io/v3/onramp/verification/status`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/docs/onramp/verification/status/post.ts> (a function with typed inputs; its response is checked against the schema)

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[]
  - `transaction_limits` CustomerTransactionLimits
    - `livemode` boolean, required
    - `limits` object, required: Remaining limits keyed by source currency and payment method

## Other responses

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

## Changes

- **2026-09-01** `582d7d2382db`: 1 info
  - added the optional property `transaction_limits` to the response with the `200` status

[Operation history](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/changes/onramp/verification/status/post.md)

---

[API](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3.md) - [All operations](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/revisions/3535f46f4c27?raw)