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	Roles held by the officer within the current company
companies	array of Companies	Other companies managed by the same person (natural or legal)

Companies

Field	Type	Description
name	string	Name of the company
siren	string	SIREN number of the company
roles	array of Roles	Roles held by the officer within this company

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

Returns a paginated list of company officers by provider priority. If you wish to exclude auditor officers from the results, you can include the exclude_auditors parameter:

GET/api/v6/users/{userId}/company-officers?exclude_auditors=1

GET/api/v6/users/{userId}/company-officers/all

Returns all officers from all providers (without priority filtering).

GET/api/v6/users/{userId}/company-officers/{officerId}

Returns the details of a specific officer.

GET/api/v6/officers?last_name=DUPONT&birth_date=1975-06-15

Search for officers across all companies by last name and birth date.

Parameter	Required	Description
last_name	Yes	Last name to search
birth_date	Yes	Birth date (YYYY-MM-DD)
first_name	No	First name to search