---
title: "GET /kyc/status"
method: GET
path: "/kyc/status"
---

# GET /kyc/status

`GET /kyc/status`

## Request

- Base URL: `https://api.relay.link`
- URL: `https://api.relay.link/kyc/status`
- Auth: none declared
- TypeScript: <https://skmtc.dev/relay/apis/cross-chain-solver/docs/kyc/status/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Default Response

- union
  - object
    - `orderId` string, required
    - `withdrawer` object
      - `chainId` integer, required
      - `address` string, required
    - `kyc` object, required
      - `status` 'required' | 'pending' | 'approved' | 'resubmission_required' | 'rejected', required
  - object
    - `orderId` string
    - `withdrawer` object, required
      - `chainId` integer, required
      - `address` string, required
    - `kyc` object, required
      - `status` 'required' | 'pending' | 'approved' | 'resubmission_required' | 'rejected', required

## Changes

- **2026-11-06** `25a5c7fb2383`: 2 breaking, 2 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - the response property `orderId` became optional for the status `200`
  - added the optional property `withdrawer` to the response with the `200` status
  - the `orderId` response's property pattern `^0x[0-9a-fA-F]{64}$` was added for the status `200`
- **2026-11-05** `df0e189a64c2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/relay/apis/cross-chain-solver/changes/kyc/status/get.md)

---

[API](https://skmtc.dev/relay/apis/cross-chain-solver.md) - [All operations](https://skmtc.dev/relay/apis/cross-chain-solver/llms.txt) - [OpenAPI document](https://skmtc.dev/relay/apis/cross-chain-solver/revisions/ed331d1e4073?raw)
