Skip to main content
Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel. Links one or more previously staged document submissions to an account as part of the verification flow. Documents must be staged first before they can be linked via this endpoint. This endpoint works the same way for business accounts (KYB) and individual accounts (KYC). For an individual account, stage each individual document, such as government_photo_id, with the person_label from the webhook payload or the list endpoint. Then link the staged IDs to the individual’s account_id with this endpoint. During verification review, Brale may request additional documents. Subscribe to account.verification.documents_required to be notified when uploads are needed, or poll required documents. See Webhook Events.

Example request

Example response (200)

status will remain "pending" while Brale reviews the submitted documents. It transitions to "complete" once verification passes or "rejected" if declined. Brale may also send account.verification.documents_required again if it needs more documents. Stage and link those the same way.

Error responses

Verification webhooks

Subscribe to verification events so your integration is notified when documents are needed or when verification completes. Create a subscription with POST /accounts/{account_id}/webhooks and include account.verification.documents_required in the events array. See the Webhooks overview for subscription setup and signature verification. Typical reactive flow (documents requested after initial submission):
  1. Create the account (POST /accounts).
  2. Brale reviews the application asynchronously.
  3. If additional documents are required, Brale sends account.verification.documents_required to your webhook URL.
  4. Stage each required document (use document_kind and person_label from the webhook payload or list endpoint when present).
  5. Link staged submissions with this endpoint.
  6. Brale reviews the documents. It may send account.verification.documents_required again, in which case repeat steps 4 and 5.
  7. When verification passes, Brale sends account.verification.completed. If verification is declined, Brale sends account.verification.rejected.

Required scope

accounts:write