API - Description - B2B - RECSIRET - Response

Support DQE
Support DQE
  • Updated

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 Additional address information 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(13) 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