---
title: "Add documents"
method: POST
path: "/v2/users/{userId}/kyc/documents"
tags: ["Kyc"]
---

# Add documents

`POST /v2/users/{userId}/kyc/documents`

Add documents to the user's KYC.

## Path parameters

- `userId` string, required

## Request body

- union
  - object[] — An array of documents to be added.
    - `type` 'DRIVERS' | 'ID_CARD' | 'PASSPORT' | 'INCOME_SOURCE' | 'INVESTOR_DOC' | 'PAYMENT_SOURCE' | 'RESIDENCE_PERMIT' | 'SELFIE' | 'PROOF_OF_ADDRESS' | 'AUTH_LETTER' | 'OTHER', required — Type of the document. This field is immutable once created.
    - `subType` 'FRONT_SIDE' | 'BACK_SIDE' | 'SINGLE_SIDE', required — Subtype of the document. This field is immutable once created.
    - `issuedCountry` string, required — Three-letter alpha-3 country code as defined in the ISO 3166-1 spec.
    - `issuedDate` string, date — Date of issue of the document.
    - `expiryDate` string, date — Expiry date of the document.
    - `number` string — If applicable, unique identification number of the document.
    - `description` string — Description of the document. Required if type is `OTHER`.
    - `url` string — URL of the document. Either `url` or `fileId` is required, but not both. *Maximum file size 10MB and minimum file size 10KB *Valid file types: .pdf, .jpeg, .jpg, .png, .heic, .tif
    - `fileId` string — The file ID returned from the file upload endpoint. Either `url` or `fileId` is required, but not both.
    - `uboId` string — If provided, this document will be attached to the specified UBO. This field is immutable once created.
  - object[] — An array of documents to be added.
    - `type` 'DIRECTORS_REGISTRY' | 'GOOD_STANDING_CERT' | 'INCORPORATION_ARTICLES' | 'INCORPORATION_CERT' | 'INCUMBENCY_CERT' | 'INFORMATION_STATEMENT' | 'POWER_OF_ATTORNEY' | 'PROOF_OF_ADDRESS' | 'SHAREHOLDER_REGISTRY' | 'STATE_REGISTRY' | 'TRUST_AGREEMENT' | 'SOURCE_OF_FUNDS' | 'FORMATION_CERT' | 'REGISTRATION_CERT' | 'PROOF_OF_OWNERSHIP' | 'CONSTITUTION_OR_ANNUAL_REPORT' | 'ARTICLES_OF_ASSOCIATION' | 'UBO_DECLARATION' | 'PARTNERSHIP_MINS_OF_MEETING' | 'PARTNERSHIP_DEED' | 'FLOW_OF_FUNDS' | 'SOURCE_OF_FUNDS' | 'ORGANIZATION_STRUCTURE' | 'SHARE_STRUCTURE' | 'BUSINESS_REGISTRATION' | 'OTHER', required — Type of the document. This field is immutable once created.
    - `subType` 'SINGLE_SIDE', required — Subtype of the document. This field is immutable once created.
    - `issuedCountry` string, required — Three-letter alpha-3 country code as defined in the ISO 3166-1 spec.
    - `issuedDate` string, date — Date of issue of the document.
    - `expiryDate` string, date — Expiry date of the document.
    - `number` string — If applicable, unique identification number of the document.
    - `description` string — Description of the document. Required if type is `OTHER`.
    - `url` string — URL of the document. Either `url` or `fileId` is required, but not both. *Maximum file size 10MB and minimum file size 10KB *Valid file types: .pdf, .jpeg, .jpg, .png, .heic, .tif
    - `fileId` string — The file ID returned from the file upload endpoint. Either `url` or `fileId` is required, but not both.
    - `uboId` string — If provided, this document will be attached to the specified UBO. This field is immutable once created.

## Response `200`

Success

- DocumentObjectList
  - `count` integer — Number of documents.
  - `data` DocumentObject[]
    - `type` string
    - `subType` string
    - `issuedCountry` string
    - `issuedDate` string, date
    - `expiryDate` string, date
    - `number` string
    - `description` string
    - `url` string
    - `fileId` string
    - `uboId` string

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/hifibridge/apis/hifi-api.md) · [All operations](https://skmtc.net/hifibridge/apis/hifi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hifibridge/hifi-api/revisions/74d9e530fbea/schema)