Companies
This data type shows a list of legal information about companies, usually gathered from their official registrations.
These information can be obtained by research with the endpoint /companies. You can performed the research with either :
- The registration number or the company name
- The officer lastname and the officer birthdate (yyyy-mm-dd)
It gives an overview of their identification.
The Companies' history is regardless of the month history current setting.
| Field | Type | Description |
|---|---|---|
| name | string | Main denomination of the company. May differ from business/commercial names. |
| registration_number | string | Official registration code of the company. In France, this is the SIREN number. |
| registration_date | date | Date of registration as an organization with economic activities (INSEE registration date). |
| insee_closing_date | date | Date at which the organization was officially recorded as closed in the INSEE registry. |
| rncs_registration_date | date | Date of registration as a commercial company (RCS registration date). Not all entities need to register. |
| rncs_closing_date | date | Date at which the company was struck off from the trade and companies registry (RCS closing date). |
| registration_court | Registration court | Registration court object. See details below. |
| legal | Legal | Legal form information. See details below. |
| activity | Activity | Activity registered for the company. See details below. |
| capital | Capital | Capital stock information. See details below. |
| address | Address | Company address. See details below. |
Registration court
| Field | Type | Description |
|---|---|---|
| name | string | Name (location) of the local commercial registry where the company has its main commercial registration. It may have other registrations if it operates in different regions, and this contains the main registration if it is registered at all. |
| code | string | 4-digit code of the local commercial registry where the company is registered. |
Legal
| Field | Type | Description |
|---|---|---|
| person_type | string | Type of person from the point of view of the law, can be either
|
| form | string | Name of the legal form of the company. |
| code_form | string | Code of the legal form of the company. |
Activity
This object represents an activity exercised by a company. The codes and names follow French norms.
| Field | Type | Description |
|---|---|---|
| ape_code | string | Activity Code. This identifies a sector of activity. |
| ape_code_type | string | Activity Code naming scheme. The naming scheme evolved several times since its inception, and not all naming schemes are compatible with their succeeding version. French: Type de code APE |
| ape_name | string | Title of the activity identified by the code. This is a short name for the activity identified by `ape_code`. |
Capital
| Field | Type | Description |
|---|---|---|
| type | string | Type of capital stock.
|
| amount | int | Amount (money) of capital stock |
| currency | Currency | Currency of the capital stock |
Address
| Field | Type | Description |
|---|---|---|
| city | string | Name of the city |
| postal_code | string | Code of the city within the country |
| country | string | An ISO code of the country |
Endpoints
GET
/api/v6/companies?q={query}Search for companies by name or registration number.
| Parameter | Required | Description |
|---|---|---|
q | Yes | Company name or SIREN to search |
GET
/api/v6/companies?last_name={lastName}&birth_date={birthDate}Search for companies by officer information.
| Parameter | Required | Description |
|---|---|---|
last_name | Yes | Officer's last name |
birth_date | Yes | Officer's birth date (YYYY-MM-DD) |
first_name | No | Officer's first name |