API - Description - B2B - RECSIRET - Response

Support DQE

Updated 04 March 2026 07:04

RECSIRET request success

The JSON response is a dictionary whose keys are DATA1, DATA2, etc. up to DATAxx and each value e st a dictionary containing the list of the company's elementary data. It contains the key "SEARCH_REF" that will be necessary to retrieve the details of the company :

Key	Value	France	International
SEARCH_REF	Search Reference	STRING	STRING
CompanyCName	Complementary name of the company (or trade name)	STRING(50)	STRING(255)
LegalStructureLabel	Legal form of the company (label)	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: The company is in operation 0: the company is 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	May include the second part of the CompanyName if the name is too long	STRING(38)	STRING(50)
Locality	City of the company	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)	STRING
LegalStructureCode	Legal form of the company (code)	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)

StaffCount value :

StaffCount value
Not declared
Non-employer
0
1-2
3-5
6-9
10-19
20-49
50-99
100-199
200-249
250-499
500-999
1000-1999
2000-4999
5000-9999
10000+

Example :

{
"DATA1": {
   "SEARCH_REF": "_29613410",
   "CompanyCName": "DQE",
   "CompanyAddress1": "DQE",
   "IncorporationDate": "2017-12-29",
   "LegalStructureLabel": "SAS, société par actions simplifiée",
   "CompanyStatus": "0",
   "CompanyName": "DQE SOFTWARE",
   "CompanyAddress2": "102 RUE VICTOR HUGO",
   "CompanyAddress3": "",
   "Locality": "LEVALLOIS PERRET",
   "DissolutionDate": "",
   "Phone": "0171199739",
   "MainCompanyFlag": "1",
   "StaffCount": "",
   "CompanySIC": "5829C",
   "LegalStructureCode": "5710",
   "IntraNumber": "FR 85 504403387",
   "ZIP_Code": "92300",
   "TurnOver": "",
   "CompanyNumber": "504xxxxxxxxxxx"
}
}

RECSIRET request error

Company Name Only

Error type	Request	Response type
Missing “Licence” parameter	https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA	400 Bad Request Error
Empty “Licence” parameter	https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence=	400 Bad Request Error
Missing or Empty “CompanyName” parameter	https://{SERVER_ADDRESS}/RECSIRET/?Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}	{ "DATA1": { "SEARCH_REF": "", "CompanyCName": "", "IncorporationDate": "", "MainCompanyFlag": "", "CompanyStatus": "", "CompanyName": "", "CompanyAddress2": "", "CompanyAddress3": "", "CompanyNumber": "", "CompanyAddress1": "", "Locality": "", "Phone": "", "DissolutionDate": "", "CompanySIC": "", "LegalStructureCode": "", "IntraNumber": "", "LegalStructureLabel": "", "TurnOver": "", "ZIP_Code": "", "StaffCount": "" } }
Error on a parameter	https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}

Company Name and Postal Code

Error type	Request	Response type
Missing “Licence” parameter	https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA	Empty response
Empty “Licence” parameter	https://{SERVER_ADDRESS}/RECSIRET/? ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence=	Empty response
Missing or Empty “CompanyName” parameter	https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} https://{SERVER_ADDRESS}/ RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName=&Dictionary= Y&Country=FRA&Licence={LICENCE_CODE}	{ "DATA1": { "SEARCH_REF": "", "CompanyCName": "", "IncorporationDate": "", "MainCompanyFlag": "", "CompanyStatus": "", "CompanyName": "", "CompanyStatus": "0", "CompanyAddress2": "", "CompanyAddress3": "", "CompanyNumber": "", "CompanyAddress1": "", "Locality": "", "Phone": "", "DissolutionDate": "", "CompanySIC": "", "LegalStructureCode": "", "IntraNumber": "", "LegalStructureLabel": "", "TurnOver": "", "ZIP_Code": "", "StaffCount": "" } }

Postal Address only

Error type	Request	Response type
Missing “Licence” parameter	https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA	400 Bad Request Error
Empty “Licence” parameter	https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence=	400 Bad Request Error
Missing or Empty “CompanyName” parameter	https://{SERVER_ADDRESS}/RECSIRET/?Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}	{ "DATA1": { "SEARCH_REF": "", "CompanyCName": "", "IncorporationDate": "", "MainCompanyFlag": "", "CompanyStatus": "", "CompanyName": "", "CompanyAddress2": "", "CompanyAddress3": "", "CompanyNumber": "", "CompanyAddress1": "", "Locality": "", "Phone": "", "DissolutionDate": "", "CompanySIC": "", "LegalStructureCode": "", "IntraNumber": "", "LegalStructureLabel": "", "TurnOver": "", "ZIP_Code": "", "StaffCount": "" } }
Error on a parameter	https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}

Related to

Was this article helpful?

0 out of 0 found this helpful