Upload Company Biometric Document
POST/v1/users/company-registrations/:company_registration_id/documents
Submit a document for company registration using multipart/form-data to submit an image file. Use the Get Pending Documents endpoint to check which documents are required.
Request
Path Parameters
Company registration 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
Submit document using multipart/form-data.
Possible values: [SELFIE, DRIVER_LICENSE_FRONT, DRIVER_LICENSE_VERSE, IDENTITY_CARD_FRONT, IDENTITY_CARD_VERSE, RNE_FRONT, RNE_VERSE, PASSPORT]
Document category.
Document file. Formats: image/jpeg, image/jpg, image/png, application/pdf. Max: 25MB.
Responses
- 201
- 400
- 401
- 403
- 404
- 422
Document submitted successfully.
- application/json
- Schema
- Example (from schema)
Schema
Document ID.
Company registration ID.
Possible values: [SELFIE, DRIVER_LICENSE_FRONT, DRIVER_LICENSE_VERSE, IDENTITY_CARD_FRONT, IDENTITY_CARD_VERSE, RNE_FRONT, RNE_VERSE, PASSPORT]
Document category.
Possible values: [PENDING, READY, FAILED]
Processing status. PENDING: Document submitted and being processed. READY: Document processed successfully. FAILED: Document processing failed.
Document creation date.
Document last update date.
{
"id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"company_registration_id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"category": "SELFIE",
"status": "PENDING",
"created_at": "2024-01-15T10:30:00.000Z",
"updated_at": "2024-01-15T10:30:00.000Z"
}
Invalid parameters.
User authentication failed.
User does not have permission to access this resource.
Company registration not found.
Business rule validation failed.