---
title: "KYC Status"
method: GET
path: "/kyc"
tags: ["kyc"]
---

# KYC Status

`GET /kyc`

Retrieve the current status of a KYC verification

## Headers

- `Authorization-Signature` string, required

## Response `200`

KYC link details

- KYCLinkResponse
  - `id` string, required
  - `type` 'individual' | 'business', required — Whether the KYC link is for an individual or a business
  - `customer_id` string, nullable
  - `full_name` string, nullable
  - `email` string, required
  - `kyc_link` string, required
  - `kyc_status` 'not_started' | 'incomplete' | 'awaiting_questionnaire' | 'awaiting_ubo' | 'under_review' | 'approved' | 'rejected' | 'paused' | 'offboarded', required — Current verification status of the KYC link
  - `rejection_reasons` KYCRejectionReason[]
    - `developer_reason` string, required
    - `reason` string, required
    - `created_at` string, required
  - `tos_link` string, required
  - `tos_status` 'pending' | 'approved', required — Whether the customer has accepted the Terms of Service
  - `created_at` string, nullable

## Other responses

- `401` — Unauthorized - Authentication required
- `404` — Not Found - No KYC verification found for this organization
- `500` — Internal Server Error

---

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