Skip to main content
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 (PATCH /accounts/{account_id}) or pass the IDs when creating an account.
This endpoint accepts multipart/form-data, not JSON. Include an Idempotency-Key header (UUID v4) on every request. See Idempotency.

​
Request fields

FieldTypeRequiredDescription
filefileYesDocument file. Accepted formats: PDF, PNG, JPG, JPEG. Maximum size: 25 MB.
document_kindstringYesDocument type code. See supported values below. Display names (for example, IRS SS-4 / 147-C EIN letter) are also accepted.
person_labelstringConditionalRequired for individual documents (government_photo_id). Must match a person on the account when linking — use available_person_labels from List Verification Documents or the person_label in an account.verification.documents_required webhook.

​
Supported document_kind values

document_kinddocument_typeDescription
articles_of_incorporationbusiness_documentArticles of Incorporation / Organization
certificate_of_good_standingbusiness_documentCertificate of Good Standing
ein_letterbusiness_documentIRS SS-4 / 147-C EIN letter
government_photo_idindividual_documentGovernment-issued photo ID (requires person_label)
othermisc_documentOther supporting documents

​
Example request

curl -X POST https://api.brale.xyz/documents \
  -H "Authorization: Bearer {access_token}" \
  -H "Idempotency-Key: {uuid}" \
  -F "[email protected]" \
  -F "document_kind=ein_letter"
For an individual document: 
curl -X POST https://api.brale.xyz/documents \
  -H "Authorization: Bearer {access_token}" \
  -H "Idempotency-Key: {uuid}" \
  -F "[email protected]" \
  -F "document_kind=government_photo_id" \
  -F "person_label=Jane Doe"

​
Example response (201)

{
  "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

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

​
Required scope

accounts:write