Get All Client Documents
GET/v1/crossborder/clients/:id/documents
Retrieve a list of all documents associated with a specific crossborder client. Optional filter parameters can be used to refine your search.
Request
Path Parameters
Client ID.
Query Parameters
Default value: 1
Page number.
Possible values: <= 100
Default value: 20
Page size. Max size is 100.
Page sort attribute.
Possible values: [asc, desc]
Default value: asc
Page order.
Possible values: [IDENTITY, PROOF_OF_ADDRESS, BANK_STATEMENT, INVOICE, CONTRACT, OTHER]
Filter by document type.
Possible values: [PENDING, APPROVED, REJECTED, EXPIRED]
Filter by document status.
Possible values: [PENDING, WAITING_UPLOAD, READY, ERROR, ABORTED]
Filter by file state.
Header Parameters
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.
Responses
- 200
- 400
- 401
- 422
Client documents returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
Page number.
Page size.
Page total.
Total of elements.
data object[]required
Client documents data.
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.
{
"page": 1,
"page_size": 20,
"page_total": 20,
"total": 100,
"data": [
{
"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-01-23T18:06:53.161Z",
"updated_at": "2026-01-23T18:06:53.161Z"
}
]
}
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.