Get User Account by ID
GET/v1/users/accounts/:id
Get an user account by id.
Request
Path Parameters
User account 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
- 422
User account returned.
- application/json
- Schema
- Example (from schema)
Schema
- NATURAL_PERSON.
- LEGAL_PERSON.
- EI.
- LTDA.
- MEI.
- SA.
- SLU.
- SS.
User account ID.
Possible values: [pending
, active
, expired
, deactivated
]
User state.
User short name or company trade name.
User full name or company name.
User gender.
User mother name.
User birth date.
User CPF or company CNPJ.
User or company phone number.
User or company e-mail.
User should start as active?
Person type:
Legal type:
User created date.
User updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"state": "active",
"name": "John",
"full_name": "John Doe",
"genre": "M",
"mother_name": "Jane Doe",
"birth_date": "1984-11-03",
"document": "11122233344",
"phone_number": "5511955551234",
"email": "new-user@zrobank.com.br",
"active": true,
"person_type": "LEGAL_PERSON",
"legal_person_type": "LTDA",
"created_at": "2025-03-11T19:15:54.405Z",
"updated_at": "2025-03-11T19:15:54.405Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.