Upload Client Document File
POST/v1/crossborder/clients/:id/documents
Upload a document file for a crossborder client (max size: 25 MB). The file will be associated with the specified client ID.
Request
Path Parameters
Client ID.
Header Parameters
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- multipart/form-data
Body
required
Document name.
Document description.
Document expiration date (YYYY-MM-DD).
Possible values: [IDENTITY, PROOF_OF_ADDRESS, BANK_STATEMENT, INVOICE, CONTRACT, OTHER]
Document type.
Document file. Required.
Responses
- 201
- 400
- 401
- 422
The file upload returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Client document ID.
Client ID.
User ID.
File ID.
Possible values: [PENDING, WAITING_UPLOAD, READY, ERROR, ABORTED]
File state.
Document name.
Document description.
Document expiration date.
Possible values: [IDENTITY, PROOF_OF_ADDRESS, BANK_STATEMENT, INVOICE, CONTRACT, OTHER]
Document type.
Possible values: [PENDING, APPROVED, REJECTED, EXPIRED]
Document status.
Document created date.
Document updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"client_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"user_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"file_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"file_state": "READY",
"name": "Identity Document",
"description": "Front side of identity document",
"expiration_date": "2025-12-31",
"type": "IDENTITY",
"status": "PENDING",
"created_at": "2026-02-13T19:26:56.547Z",
"updated_at": "2026-02-13T19:26:56.547Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.