Get Legal Person Onboarding by ID
GET/v1/users/onboardings/legal-person/:id
Get legal person onboarding by ID for the authenticated user.
Request
Path Parameters
Legal person 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.
Responses
- 200
- 400
- 401
- 403
- 422
The legal person onboarding returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Onboarding ID.
Legal person name.
Legal person CNPJ.
Possible values: [pending, finished, failed, expired]
Onboarding Status.
address object
User address ID.
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 company revenue in R$ cents.
Onboarding Created at.
{
"id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"legal_person_name": "ACME LTDA",
"cnpj": "12345678000190",
"status": "pending",
"address": {
"id": 1234,
"zip_code": "96075858",
"street": "Alameda",
"number": 10,
"neighborhood": "Alphaville",
"city": "São Paulo",
"federative_unit": "SP",
"country": "Brasil",
"complement": "flat 1201"
},
"company_revenue": 10000000,
"created_at": "2025-12-12T22:44:48.050Z"
}
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.