Upload Legal Person Onboarding Document (Step 4 of 5)
POST/v1/users/onboardings/legal-person/:id/documents
Step 4: Upload company documents.\n\nUpload the legal person (company) required documents (max size: 10 MB).\n\nRequired documents:\n- SOCIAL_CONTRACT (Contrato Social) - Always required\n- BALANCE_SHEET (Balanço Patrimonial) - Required OR REVENUE_STATEMENT\n- REVENUE_STATEMENT (Declaração de Faturamento) - Required OR BALANCE_SHEET\n\nNote: You must likely upload the Social Contract AND either the Balance Sheet OR Revenue Statement.\n\nNext step: After uploading all documents and legal representatives, finalize the onboarding: POST /legal-person/{id}/finalize
Request
Path Parameters
Onboarding 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: [contrato_social, balanco_patrimonial, declaracao_faturamento, politica_kyc_pld]
Document type. Possible values: contrato_social, balanco_patrimonial, declaracao_faturamento, politica_kyc_pld.
Allowed file formats: image/jpg, image/jpeg, image/png, application/pdf.
Responses
- 201
- 400
- 401
- 403
- 422
The onboarding document uploaded successfully.
- application/json
- Schema
- Example (from schema)
Schema
Onboarding ID.
Onboarding status.
Onboarding creation date.
Onboarding update date.
Onboarding document ID created by this upload.
File ID associated with the uploaded onboarding document.
Possible values: [contrato_social, balanco_patrimonial, declaracao_faturamento, politica_kyc_pld]
Document type of the uploaded onboarding document. Possible values: contrato_social,balanco_patrimonial,declaracao_faturamento,politica_kyc_pld
Onboarding document creation date.
Onboarding document update date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"status": "pending",
"created_at": "2025-12-12T22:44:48.056Z",
"updated_at": "2025-12-12T22:44:48.056Z",
"document_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"file_id": "151cddb6-1b0d-4a8c-bd21-e3bcf8b63226",
"document_type": "contrato_social",
"document_created_at": "2025-12-12T22:44:48.056Z",
"document_updated_at": "2025-12-12T22:44:48.057Z"
}
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.