---
title: "Submit KYB application"
method: POST
path: "/kyb/application/submit"
tags: ["KYB"]
---

# Submit KYB application

`POST /kyb/application/submit`

## Request

- Base URL: `https://api.catena.com/v1`
- URL: `https://api.catena.com/v1/kyb/application/submit`
- Auth: HTTP bearer

## Request body

- object
  - `revision` integer
  - `documentIds` string[]

## Response `200`

The organization's updated KYB snapshot

- object
  - `kyb` union, required
    - object
      - `kind` 'needs_type_selection', required
      - `status` 'pending', required
      - `canSelectIndividual` boolean, required
      - `businessFlow` 'hosted' | 'wrapped', required
    - object
      - `kind` 'in_progress', required
      - `status` 'pending' | 'in_review', required
      - `tos` union, required
        - object
          - `state` 'actionable', required
          - `url` string, required
        - object
          - `state` 'submitted', required
        - object
          - `state` 'done', required
        - object
          - `state` 'blocked', required
      - `verification` union, required
        - object
          - `state` 'actionable', required
          - `url` string, required
        - object
          - `state` 'submitted', required
        - object
          - `state` 'done', required
        - object
          - `state` 'blocked', required
    - object
      - `kind` 'rejected', required
      - `status` 'rejected', required
      - `reason` object, nullable, required
        - `rejectionReasons` object[], required
          - `reason` string, required
        - `endorsements` object[], required
          - `name` string, required
          - `status` string, required
          - `issues` string[]
          - `missing` string[]
          - `additionalRequirements` string[]
    - object
      - `kind` 'verified', required
      - `status` 'verified', required
    - object
      - `kind` 'disposed', required
      - `status` 'pending', required
      - `businessFlow` 'hosted' | 'wrapped', required

## Changes

- **2026-10-04** `19551af9f8fe`: 1 breaking
  - added `subschema #5` to the `kyb` response property `oneOf` list for the response status `200`
- **2026-09-30** `10185b806ded`: 1 breaking, 1 info
  - added required request body
  - added the required property `kyb/oneOf[subschema #1]/businessFlow` to the response with the `200` status
- **2026-09-04** `3d6cddabd5db`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/catena/apis/catena-api/changes/kyb/application/submit/post.md)

---

[API](https://skmtc.dev/catena/apis/catena-api.md) · [All operations](https://skmtc.dev/catena/apis/catena-api/llms.txt) · [OpenAPI document](https://skmtc.dev/catena/apis/catena-api/revisions/852257e39bf8?raw)