---
title: "POST /kyc/sessions"
method: POST
path: "/kyc/sessions"
---

# POST /kyc/sessions

`POST /kyc/sessions`

## Request

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

## Request body

- union
  - object
    - `orderId` string, required
    - `withdrawer` object
      - `chainId` integer, required
      - `address` string, required
  - object
    - `orderId` string
    - `withdrawer` object, required
      - `chainId` integer, required
      - `address` string, required

## 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
    - `session` object, required
      - `token` string, required
      - `sdk` object, required
        - `provider` 'persona', required
        - `inquiryId` string, required
        - `sessionToken` string, required
  - object
    - `orderId` string
    - `withdrawer` object, required
      - `chainId` integer, required
      - `address` string, required
    - `kyc` object, required
      - `status` 'required' | 'pending' | 'approved' | 'resubmission_required' | 'rejected', required
    - `session` object, required
      - `token` string, required
      - `sdk` object, required
        - `provider` 'persona', required
        - `inquiryId` string, required
        - `sessionToken` string, required

## Changes

- **2026-11-06** `25a5c7fb2383`: 2 breaking, 6 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 new optional request property `withdrawer`
  - request body became optional
  - …4 more
- **2026-11-05** `df0e189a64c2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/relay/apis/cross-chain-solver/changes/kyc/sessions/post.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)