API B2B — Rechercher des entreprises (Classic)

Support DQE
Support DQE
  • Mise à jour

Utilisez ce endpoint pour rechercher des entreprises et obtenir une liste des résultats correspondants.

Documentation API B2B Classic associée :

Requête GET

Le endpoint RECSIRET peut être interrogé par nom d'entreprise, par nom d'entreprise et code postal, ou par adresse postale.

Nom d'entreprise uniquement

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Paramètre Valeur Description Obligatoire/Optionnel
SERVER_ADDRESS {SERVER_ADDRESS} Adresse du serveur DQE qui traitera les données. Obligatoire
Licence {LICENCE_CODE} Code de licence attribué à votre compte. Obligatoire
CompanyName {COMPANY_NAME} Nom de l'entreprise ou partie du nom de l'entreprise. Obligatoire
Country {COUNTRY_CODE} Code pays ISO à 3 lettres. Obligatoire
Dictionary Y Active la recherche d'entreprise basée sur le dictionnaire. Obligatoire
Filter {FILTER} Filtre de statut d'entreprise. Plusieurs valeurs peuvent être séparées par des virgules. Optionnel. Valeur par défaut : 1.
NbMax {NB_MAX} Nombre maximum de résultats à retourner. Optionnel. Valeur par défaut : 10.
NAF25 {NAF25} Obtenir ou non la nouvelle valeur du Code Sic en France : True / False Optionnel. Valeur par défaut : False

Nom d'entreprise et code postal

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Paramètre Valeur Description Obligatoire/Optionnel
SERVER_ADDRESS {SERVER_ADDRESS} Adresse du serveur DQE qui traitera les données. Obligatoire
Licence {LICENCE_CODE} Code de licence attribué à votre compte. Obligatoire
ZIP_Code {POSTAL_CODE} Code postal ou code département. Obligatoire
CompanyName {COMPANY_NAME} Nom de l'entreprise. Obligatoire
Country {COUNTRY_CODE} Code pays ISO à 3 lettres. Obligatoire
Dictionary Y Active la recherche d'entreprise basée sur le dictionnaire. Obligatoire
Filter {FILTER} Filtre de statut d'entreprise. Plusieurs valeurs peuvent être séparées par des virgules. Optionnel. Valeur par défaut : 1.
NbMax {NB_MAX} Nombre maximum de résultats à retourner. Optionnel. Valeur par défaut : 10.
NAF25 {NAF25} Obtenir ou non la nouvelle valeur du Code Sic en France : True / False Optionnel. Valeur par défaut : False

Adresse postale uniquement

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Paramètre Valeur Description Obligatoire/Optionnel
SERVER_ADDRESS {SERVER_ADDRESS} Adresse du serveur DQE qui traitera les données. Obligatoire
Licence {LICENCE_CODE} Code de licence attribué à votre compte. Obligatoire
Address {ADDRESS} Type de voie et nom de voie de l'adresse de l'entreprise à vérifier. Obligatoire
CP {POSTAL_CODE} Code postal de l'adresse de l'entreprise à vérifier. Obligatoire
City {CITY} Nom de la ville de l'adresse de l'entreprise à vérifier. Obligatoire
Country {COUNTRY_CODE} Code pays ISO à 3 lettres. Obligatoire
Dictionary Y Active la recherche d'entreprise basée sur le dictionnaire. Obligatoire
Filter {FILTER} Filtre de statut d'entreprise. Plusieurs valeurs peuvent être séparées par des virgules. Optionnel. Valeur par défaut : 1.
NbMax {NB_MAX} Nombre maximum de résultats à retourner. Optionnel. Valeur par défaut : 10.
NAF25 {NAF25} Obtenir ou non la nouvelle valeur du Code Sic en France : True / False Optionnel. Valeur par défaut : False

Valeurs du filtre

Valeur Description
1 Entreprises diffusibles ouvertes.
2 Entreprises diffusibles fermées.
3 Anciennes entreprises diffusibles fermées depuis plus de 3 ans.
4 Entreprises non diffusibles.
5 Enregistrements RNA.

Requête POST

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/

Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded.

Nom d'entreprise uniquement

Paramètre Valeur Description Obligatoire/Optionnel
Licence {LICENCE_CODE} Code de licence attribué à votre compte. Obligatoire
CompanyName {COMPANY_NAME} Nom de l'entreprise ou partie du nom de l'entreprise. Obligatoire
Country {COUNTRY_CODE} Code pays ISO à 3 lettres. Obligatoire
Dictionary Y Active la recherche d'entreprise basée sur le dictionnaire. Obligatoire
Filter {FILTER} Filtre de statut d'entreprise. Plusieurs valeurs peuvent être séparées par des virgules. Optionnel. Valeur par défaut : 1.
NbMax {NB_MAX} Nombre maximum de résultats à retourner. Optionnel. Valeur par défaut : 10.
NAF25 {NAF25} Obtenir ou non la nouvelle valeur du Code Sic en France : True / False Optionnel. Valeur par défaut : False

Nom d'entreprise et code postal

Paramètre Valeur Description Obligatoire/Optionnel
Licence {LICENCE_CODE} Code de licence attribué à votre compte. Obligatoire
ZIP_Code {POSTAL_CODE} Code postal ou code département. Obligatoire
CompanyName {COMPANY_NAME} Nom de l'entreprise. Obligatoire
Country {COUNTRY_CODE} Code pays ISO à 3 lettres. Obligatoire
Dictionary Y Active la recherche d'entreprise basée sur le dictionnaire. Obligatoire
Filter {FILTER} Filtre de statut d'entreprise. Plusieurs valeurs peuvent être séparées par des virgules. Optionnel. Valeur par défaut : 1.
NbMax {NB_MAX} Nombre maximum de résultats à retourner. Optionnel. Valeur par défaut : 10.
NAF25 {NAF25} Obtenir ou non la nouvelle valeur du Code Sic en France : True / False Optionnel. Valeur par défaut : False

Adresse postale uniquement

Paramètre Valeur Description Obligatoire/Optionnel
Licence {LICENCE_CODE} Code de licence attribué à votre compte. Obligatoire
Address {ADDRESS} Type de voie et nom de voie de l'adresse de l'entreprise à vérifier. Obligatoire
CP {POSTAL_CODE} Code postal de l'adresse de l'entreprise à vérifier. Obligatoire
City {CITY} Nom de la ville de l'adresse de l'entreprise à vérifier. Obligatoire
Country {COUNTRY_CODE} Code pays ISO à 3 lettres. Obligatoire
Dictionary Y Active la recherche d'entreprise basée sur le dictionnaire. Obligatoire
Filter {FILTER} Filtre de statut d'entreprise. Plusieurs valeurs peuvent être séparées par des virgules. Optionnel. Valeur par défaut : 1.
NbMax {NB_MAX} Nombre maximum de résultats à retourner. Optionnel. Valeur par défaut : 10.
NAF25 {NAF25} Obtenir ou non la nouvelle valeur du Code Sic en France : True / False Optionnel. Valeur par défaut : False

Valeurs du filtre

Valeur Description
1 Entreprises diffusibles ouvertes.
2 Entreprises diffusibles fermées.
3 Anciennes entreprises diffusibles fermées depuis plus de 3 ans.
4 Entreprises non diffusibles.
5 Enregistrements RNA.

Réponse

Succès

La réponse JSON est un dictionnaire dont les clés sont DATA1, DATA2, etc. Chaque valeur est un dictionnaire contenant les données de l'entreprise. Il contient la clé SEARCH_REF, nécessaire pour récupérer les informations complètes de l'entreprise via SIRETINFO.

Clé Valeur France International
SEARCH_REF Référence de recherche, à utiliser en entrée de SIRETINFO. STRING STRING
CompanyCName Nom complémentaire de l'entreprise (ou nom commercial). STRING(50) STRING(255)
LegalStructureLabel Forme juridique de l'entreprise (libellé). STRING(100) STRING(100)
IncorporationDate Date d'installation de l'entreprise dans la ville actuelle. STRING STRING
MainCompanyFlag 1 : siège social ; 0 : autre établissement de l'entreprise. STRING(1) STRING(1)
CompanyStatus 1 : entreprise en activité ; 0 : entreprise qui n'est plus en activité. STRING(1) STRING(1)
CompanyName Nom de l'entreprise. STRING(131) STRING(255)
CompanyAddress2 Adresse de l'entreprise. STRING(38) STRING(50)
CompanyAddress3 Informations complémentaires d'adresse. STRING(38) STRING(50)
CompanyAddress1 Peut contenir la deuxième partie du CompanyName si le nom est trop long. STRING(38) STRING(50)
Locality Ville de l'entreprise. STRING(38) STRING(50)
Phone N'est plus utilisé.
DissolutionDate Date à laquelle l'entreprise a cessé son activité. STRING STRING
StaffCount Nombre d'employés. Voir les valeurs de StaffCount ci-dessous. STRING STRING
CompanySIC Code NAF de l'entreprise. STRING(5) STRING
LegalStructureCode Forme juridique de l'entreprise (code). STRING(4) STRING(4)
IntraNumber Numéro de TVA intracommunautaire.
Ce champ est vide si l'entreprise n'est pas assujettie à la TVA.		 STRING(15) STRING
ZIP_Code Code postal de la ville de l'entreprise. STRING(5) STRING(10)
TurnOver N'est plus utilisé.
CompanyNumber Numéro SIRET de l'entreprise. STRING(14) STRING(14)
Country Code pays ISO à 3 lettres. STRING(3) STRING(3)

Valeurs de StaffCount :

Valeur de StaffCount
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+

Exemple :

{
  "DATA1": {
    "SEARCH_REF": "_13367292",
    "CompanyCName": "",
    "IncorporationDate": "2024-06-24",
    "LegalStructureLabel": "Société européenne",
    "CompanyStatus": "1",
    "CompanyName": "DECATHLON",
    "CompanyAddress1": "",
    "CompanyAddress2": "52 ALLEE LAKANAL",
    "CompanyAddress3": "",
    "Locality": "VILLENEUVE D ASCQ",
    "DissolutionDate": "",
    "Phone": "",
    "MainCompanyFlag": "0",
    "StaffCount": "Non-employer",
    "CompanySIC": "8559A",
    "LegalStructureCode": "5800",
    "IntraNumber": "FR 51 306138900",
    "ZIP_Code": "59650",
    "TurnOver": "",
    "CompanyNumber": "306xxxxxxxxxxx",
    "Country": "FRA"
  }
}

Erreur

Nom d'entreprise uniquement

Type d'erreur Requête Type de réponse
Paramètre Licence manquant https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA 400 Bad Request Error
Paramètre Licence vide https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= 400 Bad Request Error
Paramètre CompanyName manquant ou vide 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": ""
  }
}
Erreur sur un paramètre https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} Même réponse vide que ci-dessus

Nom d'entreprise et code postal

Type d'erreur Requête Type de réponse
Paramètre Licence manquant https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA Réponse vide
Paramètre Licence vide https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= Réponse vide
Paramètre CompanyName manquant ou vide 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} 		Même réponse vide que ci-dessus

Adresse postale uniquement

Type d'erreur Requête Type de réponse
Paramètre Licence manquant https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA 400 Bad Request Error
Paramètre Licence vide https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence= 400 Bad Request Error
Erreur sur un paramètre https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} Même réponse vide que ci-dessus

Documentation Swagger

Voir aussi

Associé à

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 0