API B2B — Obtenir des informations sur une entreprise (REST)

Support DQE
Support DQE
  • Mise à jour

Utilisez cet endpoint pour obtenir des informations légales et administratives détaillées sur une entreprise sélectionnée.

Documentation API B2B Restful associée :

Requête GET

Forme compressée

GET https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF={SEARCHREF}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&extension={EXTENSION}

Remplacez simplement les éléments entre accolades par vos informations.

Paramètre Description Obligatoire/Optionnel
SERVER_ADDRESS Adresse du serveur DQE qui traitera les données. Obligatoire
VERSION Version de l'API. Exemple : v1 Obligatoire
Licence Numéro qui vous a été attribué comme code de licence. Obligatoire
SEARCH_REF Référence de recherche renvoyée par l'endpoint Lookup. Obligatoire
Country Code pays ISO à 3 lettres. Obligatoire
extension Si défini sur all, renvoie la forme étendue (JSON complet). Optionnel. Valeur par défaut : 1
NAF25 Obtenir la nouvelle valeur du Sic Code en France ou non : True / False Optionnel. Valeur par défaut : False

Forme étendue

GET https://{SERVER_ADDRESS}/{VERSION}/infocnum/CompanyNumber={INPUT}/?&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}
Paramètre Description Obligatoire/Optionnel
SERVER_ADDRESS Adresse du serveur DQE qui traitera les données. Obligatoire
VERSION Version de l'API. Exemple : v1 Obligatoire
Licence Numéro qui vous a été attribué comme code de licence. Obligatoire
CompanyNumber Numéro SIRET de l'entreprise. Obligatoire
Country Code pays ISO à 3 lettres. Obligatoire
NAF25 Obtenir la nouvelle valeur du Sic Code en France ou non : True / False Optionnel. Valeur par défaut : False

Requête POST

Ajoutez les paramètres ci-dessous dans le corps de la requête en utilisant x-www-form-urlencoded.

Forme compressée

POST https://{SERVER_ADDRESS}/{VERSION}/infosr/
Paramètre Description Obligatoire/Optionnel
Licence Numéro qui vous a été attribué comme code de licence. Obligatoire
SEARCH_REF Référence de recherche renvoyée par l'endpoint Lookup. Obligatoire
Country Code pays ISO à 3 lettres. Obligatoire
extension Si défini sur all, renvoie la forme étendue (JSON complet). Optionnel. Valeur par défaut : 1
NAF25 Obtenir la nouvelle valeur du Sic Code en France ou non : True / False Optionnel. Valeur par défaut : False

Forme étendue

POST https://{SERVER_ADDRESS}/{VERSION}/infocnum/{CompanyNumber}/
Paramètre Description Obligatoire/Optionnel
Licence Numéro qui vous a été attribué comme code de licence. Obligatoire
CompanyNumber Numéro SIRET de l'entreprise. Obligatoire
Country Code pays ISO à 3 lettres. Obligatoire
NAF25 Obtenir la nouvelle valeur du Sic Code en France ou non : True / False Optionnel. Valeur par défaut : False

Réponse

Succès

Forme compressée

La réponse JSON est un objet contenant deux clés principales :

  • Found : nombre d'entreprises trouvées.
  • Companies : liste contenant un ou plusieurs objets entreprise.

Chaque objet entreprise contient les clés suivantes :

Clé Description Type / Contraintes
L1Standardized Ligne d'adresse standardisée 1, souvent la dénomination sociale. String, jusqu'à 255 caractères
MainCompanyFlag Indique s'il s'agit de l'enregistrement principal de l'entreprise. 1 : oui ; 0 : non. String ou integer
CompanyStatus Statut administratif de l'entreprise. String ou integer
Country Code pays ISO 3166-1 alpha-3. String, 3 caractères
VatNumber Numéro de TVA intracommunautaire.
Ce champ est vide si l'entreprise n'est pas assujettie à la TVA.
String
City Ville où l'entreprise est située. String, jusqu'à 100 caractères
SearchRef Référence interne reliant le résultat à la requête de recherche. String
PhoneNumber Numéro de téléphone de l'entreprise. String
LegalStructure Forme juridique de l'entreprise. Tableau d'objets : { Value, Label }
L2Standardized Ligne d'adresse standardisée 2. String
Email Adresse email de l'entreprise. String
CompanyNumber Identifiants légaux, tels que SIREN et NIC. Tableau d'objets : { Type, Value }
CompanyCName Nom commercial ou nom alternatif de l'entreprise. String
Fax Numéro de fax de l'entreprise. String
IncorporationDate Date de création de l'entreprise. String, YYYY-MM-DD
StaffCount Nombre d'employés ou tranche d'effectif. String
L5Standardized Ligne d'adresse standardisée 5. String
DissolutionDate Date de dissolution de l'entreprise, le cas échéant. String, YYYY-MM-DD
Classification Codes de classification d'activité, tels que le NAF. Tableau d'objets : { Type, Value, Label }
L4Standardized Adresse de rue standardisée. String
CompanyName2 Nom secondaire de l'entreprise. String
TurnOver Chiffre d'affaires déclaré. String ou number
PosCod Code postal. String, jusqu'à 10 caractères

Exemple :

{
  "Found": 1,
  "Companies": [
    {
      "L1Standardized": "LAPIED CARRELAGE",
      "MainCompanyFlag": "1",
      "CompanyStatus": "1",
      "Country": "FRA",
      "VatNumber": "FR 62 402284269",
      "City": "MONETEAU",
      "SearchRef": "_24663079",
      "PhoneNumber": "",
      "LegalStructure": [{"Value": "5499", "Label": "Société à responsabilité limitée (sans autre indication)"}],
      "L2Standardized": "",
      "Email": "",
      "CompanyNumber": [{"Type": "Siren", "Value": "402284269"}, {"Type": "Nic", "Value": "00022"}],
      "CompanyCName": "",
      "Fax": "",
      "IncorporationDate": "2000-09-15",
      "StaffCount": "3-5",
      "L5Standardized": "",
      "DissolutionDate": "",
      "Classification": [{"Type": "NAF08", "Value": "4333Z", "Label": ""}],
      "L4Standardized": "4 RUE DES CAILLOTTES",
      "CompanyName2": "",
      "TurnOver": "",
      "PosCod": "89470"
    }
  ]
}

Forme étendue

La réponse JSON est un objet contenant deux clés principales :

  • Found : nombre d'entreprises trouvées.
  • Companies : liste contenant un ou plusieurs objets entreprise.

Chaque objet entreprise contient les clés suivantes :

Clé Description Type / Contraintes
Title Titre associé à l'enregistrement de l'entreprise. String
ClassificationEnt Codes de classification d'activité au niveau de l'entreprise. Tableau d'objets : { Type, Value, Label }
Department Code du département français. String
SocialSolidarityEconomy Indicateur de classification en économie sociale et solidaire. String
ActivityType Type d'activité. String
RangeCodeStaffCountEnt Code de tranche d'effectif de l'entreprise. String
PhoneNumber Numéro de téléphone de l'entreprise. String
CompanyNumber Identifiants légaux, tels que SIREN et NIC. Tableau d'objets : { Type, Value }
CityId Identifiant interne de la ville. String
NatureCode Code représentant la nature de l'entreprise. String
StreetName Nom de la rue sans numéro. String
District District ou arrondissement. String
FourthActivityEnt Quatrième activité déclarée de l'entreprise. String
State Libellé de la région. String
NatureLastUpdate Indicateur du type de mise à jour de la nature. String
Acronym Sigle de l'entreprise. String
ThirdActivityEnt Troisième activité déclarée de l'entreprise. String
DistributionDate Date de distribution ou de publication. String
EntYearValidity Année de validité pour les modifications des données de l'entreprise. String
L1Standardized Ligne d'adresse standardisée 1. String
StartDateActivities Date de début des activités. String, YYYY-MM-DD
L2Registered Ligne d'adresse enregistrée 2. String
Distribution Indicateur de distribution. String
L3Standardized Ligne d'adresse standardisée 3. String
Seasonality Indicateur de saisonnalité. String
EmployementArea Code de la zone d'emploi. String
PosCod Code postal. String
Category Catégorie de taille de l'entreprise. String
SecondActivityEnt Deuxième activité déclarée de l'entreprise. String
FirstName Prénom du représentant. String
IndPublipo Indicateur de publicité. String
MainActivityMethodEnt Méthode utilisée pour déterminer l'activité principale. String
L6Registered Ligne d'adresse enregistrée 6. String
L4Standardized Ligne d'adresse standardisée 4. String
CharityNumber Identifiant d'association caritative enregistrée, le cas échéant. String
NatureLabel Libellé décrivant la nature de l'entreprise. String
ProductiveEnt Indicateur d'entreprise productive. String
Classification Codes de classification d'activité. Tableau d'objets : { Type, Value, Label }
L4Registered Ligne d'adresse enregistrée 4. String
City Nom de la ville. String
StateCode Code administratif de la région. String
ActivityPlace Lieu où se déroule l'activité principale. String
SpecificProduction Indicateur de production spécifique. String
RangeLabelStaffCount Libellé de la tranche d'effectif. String
NicHeadquarter Identifiant NIC du siège. String
ClassificationYear Année associée à la classification d'activité. String
MainActivityMethod Méthode utilisée pour définir l'activité principale. String
TurnOver Chiffre d'affaires de l'entreprise. String ou number
IncorporationDateEnt Date de constitution de l'entreprise. String, YYYY-MM-DD
StaffCountYearEnt Année de référence pour l'effectif de l'entreprise. String
UrbanUnitNumber Code de l'unité urbaine. String
StaffCountYear Année de mesure de l'effectif. String
L7Standardized Ligne d'adresse standardisée 7. String
StaffCountEnt Effectif de l'entreprise. String
StoreType Classification du type de magasin. String
IncorporationDate Date de constitution de l'entreprise. String, YYYY-MM-DD
RangeLabelStaffCountEnt Libellé de la tranche d'effectif de l'entreprise. String
StreetNum Numéro de rue. String
RangeCodeStaffCount Code représentant la tranche d'effectif. String
L5Standardized Ligne d'adresse standardisée 5. String
MainActivity Code de l'activité principale. String
AuxiliaryActivity Code de l'activité auxiliaire. String
PoBox Numéro de boîte postale. String
StreetType Type de voie. String
VatNumber Numéro d'identification à la TVA. String
Email Adresse email de l'entreprise. String
StaffCount Effectif. String
L3Registered Ligne d'adresse enregistrée 3. String
L1Registered Ligne d'adresse enregistrée 1. String
UrbanUnitDpt Code départemental de l'unité urbaine. String
UrbanUnitRange Tranche de l'unité urbaine. String
L6Standardized Ligne d'adresse standardisée 6. String
Origine Origine de l'enregistrement de l'entreprise. String
CompNum Numéro d'entreprise supplémentaire. String
CompanyCName Nom commercial de l'entreprise. String
Headquarter Indique si l'enregistrement est le siège social. String ou integer
L2Standardized Ligne d'adresse standardisée 2. String
Productive Indicateur d'établissement productif. String
LastName Nom de famille du représentant. String
NatureLastUpdate1 / NatureLastUpdate2 / NatureLastUpdate3 Indicateurs supplémentaires de mise à jour de la nature. String
DetailCityRange Code détaillé de la tranche de la ville. String
MonoActivity Indique si l'entreprise a une activité unique. String
L5Registered Ligne d'adresse enregistrée 5. String
StateCodeEnt Code de région de l'entreprise. String
County Code du canton. String
L7Registered Ligne d'adresse enregistrée 7. String
ClassificationYearEnt Année de classification de l'entreprise. String
LegalStructure Liste des formes juridiques. Tableau d'objets : { Value, Label }
LongCompanyName Dénomination sociale officielle complète. String
SocialSolidarityEconomyDate Date d'entrée dans l'économie sociale et solidaire. String
CityIdEn Identifiant étendu de la ville. String
PublicCompCoopIntercom Code de coopération intercommunale. String
FirstActivityEnt Première activité déclarée de l'entreprise. String
LastUpdate Date de la dernière mise à jour des données. String
MainActivityEnt Code de l'activité principale de l'entreprise. String
DistributionDateEnt Date de distribution des données au niveau de l'entreprise. String

Exemple :

{
  "Found": 1,
  "Companies": [
    {
      "Title": "",
      "ClassificationEnt": [{"Type": "NAF08", "Value": "4333Z", "Label": "Travaux de revêtement des sols et des murs"}],
      "Department": "89",
      "SocialSolidarityEconomy": "",
      "ActivityType": "",
      "RangeCodeStaffCountEnt": "02",
      "PhoneNumber": "",
      "CompanyNumber": [{"Type": "Siren", "Value": "402284269"}, {"Type": "Nic", "Value": "00022"}],
      "CityId": "263",
      "NatureCode": "",
      "StreetName": "DES CAILLOTTES",
      "District": "1",
      "FourthActivityEnt": "",
      "State": "BOURGOGNE FRANCHE COMTE",
      "NatureLastUpdate": "F",
      "Acronym": "",
      "ThirdActivityEnt": "",
      "DistributionDate": "",
      "EntYearValidity": "",
      "L1Standardized": "LAPIED CARRELAGE",
      "StartDateActivities": "2000-09-15",
      "L2Registered": "",
      "Distribution": "O",
      "L3Standardized": "",
      "Seasonality": "",
      "EmployementArea": "2612",
      "PosCod": "89470",
      "Category": "PME",
      "SecondActivityEnt": "",
      "FirstName": "",
      "IndPublipo": "",
      "MainActivityMethodEnt": "",
      "L6Registered": "89470 MONETEAU",
      "L4Standardized": "4 RUE DES CAILLOTTES",
      "CharityNumber": "",
      "NatureLabel": "",
      "ProductiveEnt": "",
      "Classification": [{"Type": "NAF08", "Value": "4333Z", "Label": "Travaux de revêtement des sols et des murs"}],
      "L4Registered": "4 RUE DES CAILLOTTES",
      "City": "MONETEAU",
      "StateCode": "27",
      "ActivityPlace": "",
      "SpecificProduction": "",
      "RangeLabelStaffCount": "3-5",
      "NicHeadquarter": "00022",
      "ClassificationYear": "1995",
      "MainActivityMethod": "",
      "TurnOver": "",
      "IncorporationDateEnt": "1995-09-01",
      "StaffCountYearEnt": "2023",
      "UrbanUnitNumber": "02",
      "StaffCountYear": "2023",
      "L7Standardized": "FRA",
      "StaffCountEnt": "",
      "StoreType": "",
      "IncorporationDate": "2000-09-15",
      "RangeLabelStaffCountEnt": "3-5",
      "StreetNum": "4",
      "RangeCodeStaffCount": "02",
      "L5Standardized": "",
      "MainActivity": "4333ZZ",
      "AuxiliaryActivity": "",
      "PoBox": "",
      "StreetType": "RUE",
      "VatNumber": "FR 62 402284269",
      "Email": "",
      "StaffCount": "",
      "L3Registered": "",
      "L1Registered": "LAPIED CARRELAGE",
      "UrbanUnitDpt": "89",
      "UrbanUnitRange": "4",
      "L6Standardized": "89470 MONETEAU",
      "Origine": "",
      "CompNum": "",
      "CompanyCName": "",
      "Headquarter": "1",
      "L2Standardized": "",
      "Productive": "",
      "LastName": "",
      "NatureLastUpdate1": "",
      "NatureLastUpdate3": "",
      "NatureLastUpdate2": "",
      "DetailCityRange": "17",
      "MonoActivity": "",
      "L5Registered": "",
      "StateCodeEnt": "",
      "County": "02",
      "L7Registered": "FRA",
      "ClassificationYearEnt": "",
      "LegalStructure": [{"Value": "5499", "Label": "Société à responsabilité limitée (sans autre indication)"}],
      "LongCompanyName": "LAPIED CARRELAGE",
      "SocialSolidarityEconomyDate": "",
      "CityIdEn": "89263",
      "PublicCompCoopIntercom": "200067114",
      "FirstActivityEnt": "",
      "LastUpdate": "2025-01-22",
      "MainActivityEnt": "",
      "DistributionDateEnt": ""
    }
  ]
}

Erreur

Forme compressée

Type d'erreur Requête Type de réponse
Paramètre Licence manquant https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Paramètre Licence vide https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA&Licence= {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Erreur sur un paramètre https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=&Country=FRA&Licence={LICENSE} {"status":400,"message":"Missing parameters","details":"SEARCH_REF","error":"bad request"}

Forme étendue

Type d'erreur Requête Type de réponse
Paramètre Licence manquant https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Paramètre Licence vide https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA&Licence= {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}

Documentation Swagger

Voir aussi

Associé à

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

Utilisateurs qui ont trouvé cela utile : 0 sur 0