Use this endpoint to retrieve detailed legal and administrative information about a selected company.
Retrieve a lighter company record using the search reference returned by the Lookup endpoint.
infosr
Request
Both GET and POST are supported.
Simply replace the items in braces with your information.
Code examples
Get "LAPIED CARRELAGE" by search reference
Add the parameters below in the body using
x-www-form-urlencoded.
Code examples
Get "LAPIED CARRELAGE" by search reference
Parameters
| Parameter | Description | Mand / Opt |
|---|---|---|
| SERVER_ADDRESS | Address of the DQE server that will process the data. | Mandatory |
| VERSION |
Version of the API. Example: v1
|
Mandatory |
| Licence | Number assigned to you as your licence code. | Mandatory |
| SEARCH_REF | Search reference returned by the Lookup endpoint. | Mandatory |
| Country | ISO 3-letter country code. | Mandatory |
| extension |
If set to all, returns the extended
form (full JSON).
Optional. Default value:
1
|
Optional |
| NAF25 |
Get the new value of Sic Code in France or not: True
/ False
Optional. Default value:
False
|
Optional |
Response
By default (compressed form), this endpoint returns a lighter
company record. Pass extension=all to receive the
extended form instead (see the Extended form section below).
The JSON response is an object containing two main keys:
- Found: number of companies found.
- Companies: list containing one or more company objects.
Each company object contains the following keys:
| Key | Description | Type / Constraints |
|---|---|---|
| L1Standardized | Standardized address line 1, often the registered name. | String, up to 255 characters |
| MainCompanyFlag |
Indicates whether this is the main company record.
1: yes; 0: no.
|
String or integer |
| CompanyStatus | Administrative status of the company. | String or integer |
| Country | ISO 3166-1 alpha-3 country code. | String, 3 characters |
| VatNumber |
Intra-Community VAT number. This field is empty if the company is not subject to VAT. |
String |
| City | City where the company is located. | String, up to 100 characters |
| SearchRef | Internal reference linking the result to the search request. | String |
| PhoneNumber | Company phone number. | String |
| LegalStructure | Legal form of the company. |
Array of objects: { Value, Label }
|
| L2Standardized | Standardized address line 2. | String |
| Company email address. | String | |
| CompanyNumber | Legal identifiers, such as SIREN and NIC. |
Array of objects: { Type, Value }
|
| CompanyCName | Commercial name or alternative company name. | String |
| Fax | Company fax number. | String |
| IncorporationDate | Company creation date. |
String, YYYY-MM-DD
|
| StaffCount | Number of employees or employee range. | String |
| L5Standardized | Standardized address line 5. | String |
| DissolutionDate | Company dissolution date, if applicable. |
String, YYYY-MM-DD
|
| Classification | Activity classification codes, such as NAF. |
Array of objects: { Type, Value, Label }
|
| L4Standardized | Standardized street address. | String |
| CompanyName2 | Secondary company name. | String |
| TurnOver | Reported turnover. | String or number |
| PosCod | Postal code. | String, up to 10 characters |
Response example
Example: "LAPIED CARRELAGE" (compressed form)
Errors
| HTTP | Error type | Response body |
|---|---|---|
| 400 |
Missing Licence parameter
|
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad
request"}
|
| 400 |
Empty Licence parameter
|
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad
request"}
|
| 400 |
Error on a parameter (e.g. empty SEARCH_REF)
|
{"status":400,"message":"Missing parameters","details":"SEARCH_REF","error":"bad
request"}
|
Test the API
Click the button below to test this endpoint live in your browser.
Open console
Retrieve the full, detailed company record directly from a company number (SIRET).
infocnum
Request
Both GET and POST are supported.
Simply replace the items in braces with your information.
Code examples
Get "LAPIED CARRELAGE" by company number
Add the parameters below in the body using
x-www-form-urlencoded.
Code examples
Get "LAPIED CARRELAGE" by company number
Parameters
| Parameter | Description | Mand / Opt |
|---|---|---|
| SERVER_ADDRESS | Address of the DQE server that will process the data. | Mandatory |
| VERSION |
Version of the API. Example: v1
|
Mandatory |
| Licence | Number assigned to you as your licence code. | Mandatory |
| CompanyNumber | Company SIRET number. | Mandatory |
| Country | ISO 3-letter country code. | Mandatory |
| NAF25 |
Get the new value of Sic Code in France or not: True
/ False
Optional. Default value:
False
|
Optional |
Response
This endpoint always returns the extended (full) company record.
The JSON response is an object containing two main keys:
- Found: number of companies found.
- Companies: list containing one or more company objects.
Each company object contains the following keys:
| Key | Description | Type / Constraints |
|---|---|---|
| Title | Title associated with the company record. | String |
| ClassificationEnt | Enterprise-level activity classification codes. |
Array of objects: { Type, Value, Label }
|
| Department | French department code. | String |
| SocialSolidarityEconomy | Indicator of social solidarity economy classification. | String |
| ActivityType | Type of activity. | String |
| RangeCodeStaffCountEnt | Staff count range code for the enterprise. | String |
| PhoneNumber | Company phone number. | String |
| CompanyNumber | Legal identifiers, such as SIREN and NIC. |
Array of objects: { Type, Value }
|
| CityId | Internal city identifier. | String |
| NatureCode | Code representing the company nature. | String |
| StreetName | Street name without number. | String |
| District | District or arrondissement. | String |
| FourthActivityEnt | Fourth declared activity of the enterprise. | String |
| State | Region or state label. | String |
| NatureLastUpdate | Indicator of nature update type. | String |
| Acronym | Company acronym. | String |
| ThirdActivityEnt | Third declared activity of the enterprise. | String |
| DistributionDate | Date of distribution or publication. | String |
| EntYearValidity | Validity year for enterprise data changes. | String |
| L1Standardized | Standardized address line 1. | String |
| StartDateActivities | Date activities started. |
String, YYYY-MM-DD
|
| L2Registered | Registered address line 2. | String |
| Distribution | Distribution indicator. | String |
| L3Standardized | Standardized address line 3. | String |
| Seasonality | Seasonality indicator. | String |
| EmployementArea | Employment area code. | String |
| PosCod | Postal code. | String |
| Category | Company size category. | String |
| SecondActivityEnt | Second declared activity of the enterprise. | String |
| FirstName | First name of the representative. | String |
| IndPublipo | Publicity indicator. | String |
| MainActivityMethodEnt | Method used for determining the main activity. | String |
| L6Registered | Registered address line 6. | String |
| L4Standardized | Standardized address line 4. | String |
| CharityNumber | Registered charity identifier, if applicable. | String |
| NatureLabel | Label describing company nature. | String |
| ProductiveEnt | Indicates if the company is productive. | String |
| Classification | Activity classification codes. |
Array of objects: { Type, Value, Label }
|
| L4Registered | Registered address line 4. | String |
| City | City name. | String |
| StateCode | Region or state administrative code. | String |
| ActivityPlace | Place where the main activity occurs. | String |
| SpecificProduction | Specific production indicator. | String |
| RangeLabelStaffCount | Staff count range label. | String |
| NicHeadquarter | NIC identifier of the headquarters. | String |
| ClassificationYear | Year associated with the activity classification. | String |
| MainActivityMethod | Method used to define the main activity. | String |
| TurnOver | Company turnover. | String or number |
| IncorporationDateEnt | Date of enterprise incorporation. |
String, YYYY-MM-DD
|
| StaffCountYearEnt | Reference year for enterprise staff count. | String |
| UrbanUnitNumber | Urban unit code. | String |
| StaffCountYear | Year for staff count measurement. | String |
| L7Standardized | Standardized address line 7. | String |
| StaffCountEnt | Enterprise staff count. | String |
| StoreType | Store type classification. | String |
| IncorporationDate | Company incorporation date. |
String, YYYY-MM-DD
|
| RangeLabelStaffCountEnt | Staff count range label for enterprise. | String |
| StreetNum | Street number. | String |
| RangeCodeStaffCount | Code representing staff count range. | String |
| L5Standardized | Standardized address line 5. | String |
| MainActivity | Main activity code. | String |
| AuxiliaryActivity | Auxiliary activity code. | String |
| PoBox | PO box number. | String |
| StreetType | Type of street. | String |
| VatNumber | VAT identification number. | String |
| Company email address. | String | |
| StaffCount | Staff count. | String |
| L3Registered | Registered address line 3. | String |
| L1Registered | Registered address line 1. | String |
| UrbanUnitDpt | Urban unit departmental code. | String |
| UrbanUnitRange | Range of the urban unit. | String |
| L6Standardized | Standardized address line 6. | String |
| Origine | Origin of the company record. | String |
| CompNum | Additional company number. | String |
| CompanyCName | Commercial company name. | String |
| Headquarter | Indicates if the record is the headquarters. | String or integer |
| L2Standardized | Standardized address line 2. | String |
| Productive | Productive establishment indicator. | String |
| LastName | Last name of the representative. | String |
| NatureLastUpdate1 / NatureLastUpdate2 / NatureLastUpdate3 | Additional update nature indicators. | String |
| DetailCityRange | Detailed city range code. | String |
| MonoActivity | Indicates whether the company has a single activity. | String |
| L5Registered | Registered address line 5. | String |
| StateCodeEnt | Enterprise state or region code. | String |
| County | County code. | String |
| L7Registered | Registered address line 7. | String |
| ClassificationYearEnt | Enterprise classification year. | String |
| LegalStructure | Legal structure list. |
Array of objects: { Value, Label }
|
| LongCompanyName | Full official company name. | String |
| SocialSolidarityEconomyDate | Date of entry into social solidarity economy. | String |
| CityIdEn | Extended city identifier. | String |
| PublicCompCoopIntercom | Intercommunal cooperation code. | String |
| FirstActivityEnt | First declared enterprise activity. | String |
| LastUpdate | Date of last data update. | String |
| MainActivityEnt | Main enterprise activity code. | String |
| DistributionDateEnt | Distribution date for enterprise-level data. | String |
Response example
Example: "LAPIED CARRELAGE" (extended form)
Errors
| HTTP | Error type | Response body |
|---|---|---|
| 400 |
Missing Licence parameter
|
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad
request"}
|
| 400 |
Empty Licence parameter
|
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad
request"}
|
Test the API
Click the button below to test this endpoint live in your browser.
Open console
See also
Related to