Upload Legal Representative Documents (Step 3 of 5)
POST/v1/users/legal-representatives/:id/documents
Step 3: Upload required documents for the legal representative.\n\nUpload the legal representative document files (max size: 25 MB).\n\nRequired documents (must be uploaded to finalize onboarding):\n- selfie - Representative selfie photo\n- identity_document - ID, CNH or Passport (requires identity_document_type)\n- qualification_declaration - Declaration of powers/qualification\n\nOptional documents:\n- income_declaration - Income declaration\n- address_proof - Proof of address\n\nNext step: Upload company documents at POST /legal-person/{id}/documents
Request
Path Parameters
Legal representative ID.
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.
- multipart/form-data
Body
required
Possible values: [id, cnh, passaporte]
Identity document type (id, cnh, passaporte).
User selfie. Always required.
Identity document (ID, CNH, Passport). Always required.
Qualification declaration perante à empresa. Always required.
Income declaration document. Optional.
Proof of address document. Optional.
Responses
- 200
- 400
- 401
- 403
- 422
The file upload returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
Legal representative document ID.
Legal representative document file ID.
Legal representative document file name.
Legal representative document file created at.
Possible values: [id, cnh, passaporte]
Identity document subtype (id, cnh, passaporte). Only for identity_document.
Legal representative document type.
[
{
"id": "1b2c3d4e-1234-5678-9abc-def012345678",
"file_id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"file_name": "selfie.jpg",
"created_at": "2025-12-12T22:44:48.069Z",
"identity_document_type": "id",
"type": "selfie"
}
]
If any required params are missing or has invalid format or type.
User authentication failed.
If the authenticated user does not have permission.
If any required params are missing or has invalid format or type.