Use this endpoint to retrieve detailed legal information about a selected company.
Related B2B Classic API documentation:
There are two ways to retrieve company details:
-
Compressed form: using the
SEARCH_REFreturned by RECSIRET. -
Extended form: using the company
Siretnumber directly.
Retrieve company details using the SEARCH_REF returned
by a previous RECSIRET search.
Compressed form
Request
Both GET and POST are supported.
Code examples
Retrieve DECATHLON by SEARCH_REF
Send the following parameters in the request body using
x-www-form-urlencoded.
Code examples
Retrieve DECATHLON by SEARCH_REF
Parameters
| Parameter | Value | Description | Mand / Opt |
|---|---|---|---|
| SERVER_ADDRESS |
{SERVER_ADDRESS}
|
Address of the DQE server that will process the data. | Mandatory |
| Licence |
{LICENCE_CODE}
|
Licence code assigned to your account. | Mandatory |
| SEARCH_REF |
{REF}
|
Company reference returned by the RECSIRET search. | Mandatory |
| Dictionary |
Y
|
Enables dictionary-based lookup. | Mandatory |
| Country |
{COUNTRY_CODE}
|
ISO 3-letter country code. | Mandatory |
| NAF25 |
{NAF25}
|
Get the new value of Sic Code in France or not : True / False |
Optional. Default value: False
|
Response
The JSON response is a dictionary whose key is DATA1.
It contains the available fields for the selected company.
| Key | Value | France | International |
|---|---|---|---|
| SEARCH_REF | Search reference. | STRING | STRING |
| CompanyCName | Complementary company name or trade name. | STRING(50) | STRING(255) |
| LegalStructureLabel | Legal form of the company. | STRING(100) | STRING(100) |
| IncorporationDate | Date of company installation in the current city. | STRING | STRING |
| MainCompanyFlag |
1: head office; 0: other
company office.
|
STRING(1) | STRING(1) |
| CompanyStatus |
1: company in operation; 0:
company no longer in operation.
|
STRING(1) | STRING(1) |
| CompanyName | Company name. | STRING(131) | STRING(255) |
| CompanyAddress2 | Company address. | STRING(38) | STRING(50) |
| CompanyAddress3 | Additional address information. | STRING(38) | STRING(50) |
| CompanyAddress1 | Additional address information. | STRING(38) | STRING(50) |
| Locality | Company city. | STRING(38) | STRING(50) |
| Phone | Not used anymore. | ||
| DissolutionDate | Date the company ceased to operate. | STRING | STRING |
| StaffCount | Number of employees. | STRING | STRING |
| CompanySIC | Company NAF code. | STRING(5) | |
| LegalStructureCode | Legal form code of the company. | STRING(4) | STRING(4) |
| IntraNumber | Intra-community VAT number. | STRING(15) | STRING |
| ZIP_Code | ZIP code of the company's city. | STRING(5) | STRING(10) |
| TurnOver | Not used anymore. | ||
| CompanyNumber | SIRET number of the company. | STRING(14) | STRING(14) |
| CompanyName2 | Additional corporate name. | STRING | STRING |
| Activity1 | Legal structure code. | STRING | STRING |
| Activity2 |
Company size, such as PME, ME,
or GE.
|
STRING(3) | STRING(3) |
| Not used anymore. | |||
| Fax | Not used anymore. | ||
| Country | ISO 3-letter country code. | STRING(3) | STRING(3) |
Response example
Example response — DECATHLON (compressed form)
Errors
| Error type | Example request | Response |
|---|---|---|
Missing Licence parameter
|
https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA
|
400 Bad Request Error |
Empty Licence parameter
|
https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA&Licence=
|
400 Bad Request Error |
| Error on a parameter |
https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
|
Empty response |
Test the API
Click the button below to test this endpoint live in your browser.
Open console
Retrieve full legal and establishment-level company details directly
from a Siret number.
Extended form
Request
Both GET and POST are supported.
Code examples
Retrieve full details for SIRET 30613890003910
Send the following parameters in the request body using
x-www-form-urlencoded.
Code examples
Retrieve full details for SIRET 30613890003910
Parameters
| Parameter | Value | Description | Mand / Opt |
|---|---|---|---|
| SERVER_ADDRESS |
{SERVER_ADDRESS}
|
Address of the DQE server that will process the data. | Mandatory |
| Licence |
{LICENCE_CODE}
|
Licence code assigned to your account. | Mandatory |
| Siret |
{SIRET}
|
SIRET number of the company. | Mandatory |
| Country |
{COUNTRY_CODE}
|
ISO 3-letter country code. | Mandatory |
| NAF25 |
{NAF25}
|
Get the new value of Sic Code in France or not : True / False |
Optional. Default value: False
|
Response
The JSON response is a dictionary containing the available fields for the selected company.
| Key | Description | France |
|---|---|---|
| DQE_status |
FOUND or NOT FOUND.
|
STRING(10) |
| SIREN | Company identifier. | STRING(9) |
| NIC | Internal classification number of the establishment. | STRING(5) |
| TVAINTRA |
Intra-Community VAT number. This field is empty if the company is not subject to VAT. |
STRING(25) |
| Address declared normalized | ||
| L1_NORMALISEE | Address line 1: company name, normalized using AFNOR standard. | STRING(38) |
| L2_NORMALISEE | Address line 2: apartment, door, stair, normalized using AFNOR standard. | STRING(38) |
| L3_NORMALISEE | Address line 3: building, normalized using AFNOR standard. | STRING(38) |
| L4_NORMALISEE | Address line 4: street and street number, normalized using AFNOR standard. | STRING(38) |
| L5_NORMALISEE | Address line 5: Cedex, PO box, place name, normalized using AFNOR standard. | STRING(38) |
| L6_NORMALISEE | Address line 6: postal code and city, normalized using AFNOR standard. | STRING(38) |
| L7_NORMALISEE | Address line 7: country in ISO3 code, normalized using AFNOR standard. | STRING(38) |
| Address declared | ||
| L1_DECLAREE | Declared address of the establishment. | STRING(38) |
| L2_DECLAREE | Declared address of the establishment. | STRING(38) |
| L3_DECLAREE | Declared address of the establishment. | STRING(38) |
| L4_DECLAREE | Declared address of the establishment. | STRING(38) |
| L5_DECLAREE | Declared address of the establishment. | STRING(38) |
| L6_DECLAREE | Declared address of the establishment. | STRING(38) |
| L7_DECLAREE | Declared address of the establishment. | STRING(38) |
| Geographic address | ||
| NUMVOIE | Street number. | STRING(4) |
| INDREP | Street number additional information. | STRING(1) |
| TYPVOIE | Street type. | STRING(4) |
| LIBVOIE | Street name. | STRING(32) |
| CODPOS | ZIP code. | STRING(5) |
| CEDEX | CEDEX code. | STRING(5) |
| Geographical location of the establishment | ||
| RPET | Region. | STRING(2) |
| LIBREG | Region label. | STRING(70) |
| DEPET | Department. | STRING(2) |
| ARRONET | District. | STRING(2) |
| CTONET | Canton. | STRING(3) |
| COMET | City. | STRING(3) |
| LIBCOM | City name. | STRING(32) |
| DU | Department of the urban unit. | STRING(2) |
| TU | Size of urban unit. | STRING(1) |
| UU | Urban unit number. | STRING(2) |
| EPCI | Location of the establishment in a public establishment of intermunicipal cooperation. | STRING(9) |
| TCD | Detailed municipal area. | STRING(2) |
| ZEMET | Employment area. | STRING(4) |
| Information about the establishment | ||
| SIEGE | Indicates whether the establishment is a head office. | STRING(1) |
| ENSEIGNE | Sign or name of the establishment. | STRING(50) |
| IND_PUBLIPO | Direct mailing field indicator. | STRING(1) |
| DIFFCOM | Distribution status of the establishment. | STRING(1) |
| AMINTRET | Year and month when the establishment was added to the database. | STRING(6) |
| Economic characteristics of the establishment | ||
| NATETAB | Nature of the establishment of an individual entrepreneur. | STRING(1) |
| LIBNATETAB | Nature label. | STRING(30) |
| APET700 | Main activity. | STRING(5) |
| LIBAPET | Main activity label. | STRING(65) |
| DAPET | Year of validity of the main activity. | STRING(4) |
| TEFET | Range of the number of employees in the establishment. | STRING(2) |
| LIBTEFET | Range name. | STRING(23) |
| EFETCENT | Number of employees in the establishment, rounded to the nearest 100. | STRING(6) |
| DEFET | Year of validity of the establishment workforce. | STRING(4) |
| ORIGINE | Origin of creation of the establishment. | STRING(2) |
| DCRET | Date of creation of the establishment. | STRING(8) |
| DDEBACT | Start date of activity. | STRING(8) |
| ACTIVNAT | Nature of the establishment activity. | STRING(2) |
| LIEUACT | Place of activity of the establishment. | STRING(2) |
| ACTISURF | Type of store. | STRING(2) |
| SAISONAT | Indicates whether the establishment activity is seasonal. | STRING(2) |
| MODET | Type of the establishment's main activity. | STRING(1) |
| PRODET | Productive nature of the establishment. | STRING(1) |
| PRODPART | Specific participation in the establishment's production. | STRING(1) |
| AUXILT | Auxiliary nature of the establishment activity. | STRING(1) |
| Company identification | ||
| NOMEN_LONG | Name or company name of the company. | STRING(131) |
| SIGLE | Company sign or logo. | STRING(20) |
| NOM | Birth name. | STRING(100) |
| PRENOM | First name. | STRING(30) |
| CIVILITE | Civility of individual entrepreneurs. | STRING(1) |
| RNA | Identification number in the national directory of associations. | STRING(10) |
| Information about the company's headquarters | ||
| NICSIEGE | Internal classification number of the head office. | STRING(5) |
| RPEN | Region where the headquarters is located. | STRING(2) |
| DEPCOMEN | Department or city where the head office is located. | STRING(5) |
| ADR_MAIL | Not used anymore. | |
| TELEPHONE | Not used anymore. | |
| Economic characteristics of the company | ||
| NJ | Legal nature of the company. | STRING(4) |
| LIBNJ | Label of the legal nature. | STRING(100) |
| APEN700 | Main activity of the company. | STRING(5) |
| LIBAPEN | Main activity label. | STRING(65) |
| DAPEN | Year of validity of the main activity. | STRING(4) |
| APRM | Main activity in the trade register. | STRING(6) |
| ESS | Belonging to the social and solidarity economy field. | STRING(1) |
| DATEESS | ESS date. | STRING(8) |
| TEFEN | Range of the number of employees in the company. | STRING(2) |
| LIBTEFEN | Range label. | STRING(23) |
| EFENCENT | Number of employees in the establishment, rounded to the nearest 100. | STRING(6) |
| DEFEN | Year of validity of the company workforce. | STRING(4) |
| CATEGORIE | Company category. | STRING(5) |
| DCREN | Creation date of the company. | STRING(8) |
| AMINTREN | Year and month when the company was added to the database. | STRING(6) |
| MONOACT | Monoactivity index of the company. | STRING(1) |
| MODEN | Type of the company's main activity. | STRING(1) |
| PRODEN / ESAANN / TCA / ESAAPEN / ESASEC1N–4N | Not used anymore. | |
| Data specific to updates | ||
| VMAJ |
Nature of the update: C establishment
creation; E establishment deletion;
I modification initial state; F
modification final state; D entry into
distribution; O exit from distribution.
|
STRING(1) |
| VMAJ1 / VMAJ2 / VMAJ3 | Not used anymore. | |
| DATEMAJ | Processing date of the update. | STRING(19) |
Response example
Example response — ASSOCIATION SPORTIVE DECATHLON (extended form)
Errors
| Error type | Example request | Response |
|---|---|---|
Missing Licence parameter
|
https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET}
|
400 Bad Request Error |
Empty Licence parameter
|
https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET}&Licence=
|
400 Bad Request Error |
Test the API
Click the button below to test this endpoint live in your browser.
Open console
See also
Related to