Company Officer
Officers are entities, whether LEGAL
or NATURAL
, that have the right to officially represent the company,
and speak for it. They usually hold one or more positions near or at the top of the organization chart.
The Company Officer's history is regardless of the month history current setting.
Field | Type | Description |
---|---|---|
id | uuid | Unique identifier (UUID) |
last_name | string | Last name of the officer, if it is a NATURAL person |
patronym | string | Birth name of the officer, if is it a NATURAL person |
first_name | string | First name of the officer, if it is a NATURAL person |
birth_date | date | Date of birth of the officer, if it is a NATURAL person |
birth_city | string | Place of birth of the officer, if it is a NATURAL person |
birth_postal_code | string | Code of the place of birth of the officer, if it is a NATURAL person |
birth_country | string | Country of birth of the officer, if it is a NATURAL person |
nationality | string | Nationality of the officer, if it is a NATURAL person |
name | string | Denomination of the officer, if it is a LEGAL person |
siren | string | Siren of the officer, if it is a LEGAL person |
type | string | Type of person from the point of view of the law, can be either LEGAL or NATURAL |
address | Address | Address of the officer |
roles | array of Roles | A roles object |
Roles
Field | Type | Description |
---|---|---|
name | string | Name of the position held by the officer |
start_date | date | Date from which the position held by the officer started |
end_date | date | Date on which the position held by the officer ended |
Endpoints
GET
/api/v6/users/{userId}/company-officers
This query allows you to retrieve officers of a specific user.
If you wish to exclude auditor officers from the results, you can include the
exclude_auditors
parameter in your query. For example:GET
/api/v6/users/{userId}/company-officers?exclude_auditors=1