Get all legal representatives

GET 
/v1/users/legal-representatives

Get all legal representatives linked to a user account.

Request

Header Parameters

nonce stringrequired

The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

x-lang string

Possible values: [pt-BR, en-US]

Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

x-product-uuid string

The product ID is a UUID (v4) used to identify the Z.ro product configuration.

x-product-target-user-uuid string

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

Legal representatives returned successfully.

application/json

Schema

Schema

data object[]required
Legal representatives data.
Array [
id stringrequired
Legal representative ID.
document objectrequired
id stringrequired
Document ID.
type stringrequired
Possible values: [CPF]
Document type.
number stringrequired
Document number.
country_of_issue stringrequired
Document country of issue.
address objectrequired
id stringrequired
Address ID.
zip_code stringrequired
ZIP code.
street stringrequired
Street.
number numberrequired
Street number.
neighborhood stringrequired
Neighborhood.
city stringrequired
City.
federative_unit stringrequired
Federative unit.
country stringrequired
Country.
complement string
Address complement.
name stringrequired
Legal representative name.
representor_type stringrequired
Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]
Legal representative qualification.
person_type stringrequired
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Person type.
income number
Income in cents.
patrimony number
Patrimony in cents.
participation_percentage number
Participation percentage.
pep booleanrequired
PEP flag.
is_public_server booleanrequired
Public server flag.
phone_number string
Phone number.
email string
Email.
registration_update_date date-timerequired
Registration update date.
birth_date date-timerequired
Birth date.
relationship_start_date date-timerequired
Relationship start date with the legal entity.
relationship_end_date date-time
Relationship end date with the legal entity.
created_at date-timerequired
Creation date.
]

Example (from schema)

{
  "data": [
    {
      "id": "d13ca8f2-4f0a-4a3d-b81e-5ee9c8bb8c56",
      "document": {
        "id": "a1df6c59-359d-4ec1-b7da-98dcc555dd76",
        "type": "CPF",
        "number": "02465676008",
        "country_of_issue": "BRA"
      },
      "address": {
        "id": "7b5e8c47-b6a3-4e29-942f-7f5ec06b26a2",
        "zip_code": "60123456",
        "street": "Main Street",
        "number": 123,
        "neighborhood": "Downtown",
        "city": "São Paulo",
        "federative_unit": "SP",
        "country": "BRA",
        "complement": "Apt 12"
      },
      "name": "Jane Doe",
      "representor_type": "PARTNER",
      "person_type": "NATURAL_PERSON",
      "income": 100000,
      "patrimony": 5000000,
      "participation_percentage": 35.5,
      "pep": false,
      "is_public_server": false,
      "phone_number": "5511955551234",
      "email": "partner@example.com",
      "registration_update_date": "2024-02-01",
      "birth_date": "1980-01-15",
      "relationship_start_date": "2020-05-01",
      "relationship_end_date": "2024-01-01",
      "created_at": "2025-12-12T22:44:48.065Z"
    }
  ]
}

400

If any required params are missing or has invalid format or type.

401

User authentication failed.

403

If the authenticated user does not have permission.

422

If any required params are missing or has invalid format or type.

Loading...