---
title: "Update multiple documents"
method: PATCH
path: "/verifications/{verification-id}/documents"
tags: ["Documents"]
---

# Update multiple documents

`PATCH /verifications/{verification-id}/documents`

## Request

- Base URL: `https://api.dlocal.com/kyc`
- URL: `https://api.dlocal.com/kyc/verifications/{verification-id}/documents`
- Auth: API key in header `X-Date` and API key in header `X-Login` and API key in header `X-Trans-Key` and API key in header `Authorization`

Updates several documents for the same verification in one request using `multipart/form-data`. Each document update is sent as its own part in the multipart body — repeat the part shape (`id` + `file` or `value`, plus optional `reference_name`) for every document you want to update in the same call.

Same rules as single-document update: changes are only allowed while each target document is in `PENDING` (not when `COMPLETED`, `ERROR`, or `APPROVED`). The response is an array with one document object per updated item.

## Request body `multipart/form-data`

- object
  - `id` string, required: dLocal verification document ID for the document being updated.
  - `file` string, binary: File with the content of the document to update. Used for documents of type `DOCUMENT` and only when `value` is not sent. Each file name must include an extension (`.jpeg`, `.png`, or `.pdf`). Please [refer to the list of acceptable documents](https://docs.dlocal.com/reference/document-information#document-names).
  - `value` string: Value of the document to update. Used for documents of type `FIELD` and only when `file` is not sent.
  - `reference_name` string: Reference name given by the merchant in their system.

## Response `200`

Successful response — one document object per updated item

- VerificationDocument[]
  - `id` string: dLocal document verification ID.
  - `type` string: Document type. [See details](https://docs.dlocal.com/reference/document-information#document-type).
  - `name` string: Document name. [See details](https://docs.dlocal.com/reference/document-information#document-names).
  - `reference_name` string: Reference name given by the merchant in their system.
  - `value` string: Value of the document for documents of type `FIELD`.
  - `status` string: Document status. [See details](https://docs.dlocal.com/reference/document-information#document-status).
  - `status_detail` string: Document status detail. [See details](https://docs.dlocal.com/reference/document-information#document-status-details).

## Other responses

- `400`: Bad request — invalid format, file type, or size
- `401`: Unauthorized — invalid credentials
- `403`: Forbidden — authentication failed or unauthorized access
- `404`: Verification not found
- `500`: Internal server error

---

[API](https://skmtc.dev/dlocal/apis/kyc-verifications.md) - [All operations](https://skmtc.dev/dlocal/apis/kyc-verifications/llms.txt) - [OpenAPI document](https://skmtc.dev/dlocal/apis/kyc-verifications/revisions/249db3120bc4?raw)