> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brale.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Stage a Verification Document

> Upload a KYB/KYC document for later linking to an account.

Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.

Uploads a verification document file and returns a `doc_submission_id`. Staged submissions are not yet associated with an account — link them with [Link Verification Documents](https://docs.brale.xyz/api-reference/brale/link-verification-documents.md) (`PATCH /accounts/{account_id}`) or pass the IDs when [creating an account](https://docs.brale.xyz/api-reference/brale/create-account.md).

> [!NOTE]
>
> This endpoint accepts `multipart/form-data`, not JSON. Include an `Idempotency-Key` header (UUID v4) on every request. See [Idempotency](https://docs.brale.xyz/key-concepts/idempotency.md).

## Request fields

| Field | Type | Required | Description |
| - | - | - | - |
| `file` | file | Yes | Document file. Accepted formats: PDF, PNG, JPG, JPEG. Maximum size: 25 MB. |
| `document_kind` | string | Yes | Document type code. See supported values below. Display names (for example, `IRS SS-4 / 147-C EIN letter`) are also accepted. |
| `person_label` | string | Conditional | Required for individual documents (`government_photo_id`). Must match a person on the account when linking — use `available_person_labels` from [List Verification Documents](https://docs.brale.xyz/api-reference/brale/list-verification-documents.md) or the `person_label` in an `account.verification.documents_required` webhook. |

### Supported `document_kind` values

| `document_kind` | `document_type` | Description |
| - | - | - |
| `articles_of_incorporation` | `business_document` | Articles of Incorporation / Organization |
| `certificate_of_good_standing` | `business_document` | Certificate of Good Standing |
| `ein_letter` | `business_document` | IRS SS-4 / 147-C EIN letter |
| `regulatory_license` | `business_document` | Regulatory License or Registration |
| `entity_registration` | `business_document` | Entity Registration Document |
| `aml_program` | `business_document` | AML Assessment or Program. Optional: never a required document, and a business can link it at any time. |
| `government_photo_id` | `individual_document` | Government-issued photo ID (requires `person_label`) |
| `other` | `misc_document` | Other supporting documents |

`regulatory_license`, `entity_registration`, and `aml_program` apply to regulated businesses outside the US under standard verification. See [Required documents for a regulated non-US business](https://docs.brale.xyz/key-concepts/accounts.md#required-documents-for-a-regulated-non-us-business).

## Example request

```bash theme={null}
curl -X POST https://api.brale.xyz/documents \
  -H "Authorization: Bearer {access_token}" \
  -H "Idempotency-Key: {uuid}" \
  -F "file=@ein-letter.pdf" \
  -F "document_kind=ein_letter"
```

For an individual document:

```bash theme={null}
curl -X POST https://api.brale.xyz/documents \
  -H "Authorization: Bearer {access_token}" \
  -H "Idempotency-Key: {uuid}" \
  -F "file=@id.pdf" \
  -F "document_kind=government_photo_id" \
  -F "person_label=Jane Doe"
```

## Example response (201)

```json theme={null}
{
  "doc_submission_id": "3Ar9BnQCKIrB3SYjKGBzCtFs6XL"
}
```

Pass the returned `doc_submission_id` to `PATCH /accounts/{account_id}` or include it in `doc_submission_ids` on account creation.

## Error responses

| Status | Cause |
| - | - |
| `400` | `file` or `document_kind` is missing, or `document_kind` is invalid. |
| `401` | Missing or invalid access token. |
| `403` | Client lacks `accounts:write` scope. |
| `422` | `person_label` is required for individual documents, file type is unsupported, or file exceeds the size limit. |

## Required scope

`accounts:write`