Update Legal Person Onboarding
PUT/v1/users/onboardings/legal-person/:id
Update an onboarding for legal person (PJ) account. You can update the headquarters or branch address and company revenue (faturamento).
Request
Path Parameters
Legal person onboarding ID.
Header Parameters
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.
- application/json
Body
required
address object
User address zip code.
User address street.
User address number.
User address neighborhood.
User address neighborhood.
User address federative unit.
User address country.
User address complement.
Legal person annual revenue in R$ cents.
Responses
- 200
- 400
- 401
- 403
- 422
Legal person onboarding updated successfully.
- application/json
- Schema
- Example (from schema)
Schema
Onboarding ID.
Possible values: [pending, finished, failed, expired]
Onboarding Status. The status will be PENDING until the corporate structure (quadro societário) is completed.
Onboarding Created at.
Onboarding Updated at.
{
"id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"status": "pending",
"created_at": "2025-12-12T22:44:48.051Z",
"updated_at": "2025-12-12T22:44:48.051Z"
}
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.