API Restful - Description - B2B - GetInfo - Response

Support DQE
Support DQE

Success

Compressed form

The JSON response is a dictionary (object) containing two main keys:

  • "Found": an integer indicating the number of addresses found (e.g., 0 or 1),
  • "Companies": a list containing one or more Company objects.

Each company object is itself a dictionary containing the following keys:

KeyDescriptionType / Constraints
L1StandardizedStandardized line 1 of the address (often the registered name).String (up to 255 characters)
MainCompanyFlagIndicates if this is the main company record (1 = yes, 0 = no).String or Integer (0/1)
CompanyStatusAdministrative status of the company (1 = active, depending on source rules).String or Integer
CountryISO 3166-1 alpha-3 country code (e.g., "FRA").String (3 characters)
VatNumberCompany VAT identification number.String
CityCity where the company is located.String (up to 100 characters)
SearchRefInternal reference linking the result to the search request.String
PhoneNumberCompany phone number.String
LegalStructureLegal form of the company; list of { Value, Label }.Array of objects
L2StandardizedStandardized line 2 of the address (secondary details).String
EmailCompany email address.String
CompanyNumberLegal identifiers (e.g., SIREN, NIC).Array of objects { Type, Value }
CompanyCNameCommercial name or alternative company name (may be empty).String
FaxCompany fax number.String
IncorporationDateCompany creation date.String (YYYY-MM-DD)
StaffCountNumber of employees (may be a range).String
L5StandardizedStandardized address line 5 (optional).String
DissolutionDateCompany dissolution date, if applicable.String (YYYY-MM-DD)
ClassificationActivity classification codes (e.g., NAF).Array of objects { Type, Value, Label }
L4StandardizedStandardized street address (street + number).String
CompanyName2Secondary company name (optional).String
TurnOverReported turnover (may be empty).String or Number
PosCodPostal code.String (up to 10 characters)

 

Example :

{
  "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"
    }
  ]
}

Extended form

The JSON response is a dictionary (object) containing two main keys:

  • "Found": an integer indicating the number of addresses found (e.g., 0 or 1),
  • "Companies": a list containing one or more Company objects.

Each company object is itself a dictionary containing the following keys:

KeyDescriptionType / Constraints
TitleTitle associated with the company record.String
ClassificationEntEnterprise-level activity classification codes.Array of objects { Type, Value, Label }
DepartmentFrench department code.String
SocialSolidarityEconomyIndicator of social solidarity economy classification.String
ActivityTypeType of activity (generic field).String
RangeCodeStaffCountEntStaff count range code for the enterprise.String
PhoneNumberCompany phone number.String
CompanyNumberLegal identifiers (SIREN, NIC, etc.).Array of objects { Type, Value }
CityIdInternal city identifier.String
NatureCodeCode representing the company nature.String
StreetNameStreet name without number.String
DistrictDistrict or arrondissement.String
FourthActivityEntFourth declared activity of the enterprise.String
StateRegion or state label.String
NatureLastUpdateIndicator of nature update type.String
AcronymCompany acronym.String
ThirdActivityEntThird declared activity of the enterprise.String
DistributionDateDate of distribution or publication.String
EntYearValidityValidity year for enterprise data changes.String
L1StandardizedStandardized address line 1.String
StartDateActivitiesDate activities started.String (YYYY-MM-DD)
L2RegisteredRegistered address line 2.String
DistributionDistribution indicator.String
L3StandardizedStandardized address line 3.String
SeasonalitySeasonality indicator.String
EmployementAreaEmployment area code.String
PosCodPostal code.String
CategoryCompany size category (e.g., PME).String
SecondActivityEntSecond declared activity of the enterprise.String
FirstNameFirst name of the representative.String
IndPublipoPublicity indicator.String
MainActivityMethodEntMethod used for determining the main activity.String
L6RegisteredRegistered address line 6.String
L4StandardizedStandardized address line 4.String
CharityNumberRegistered charity identifier, if applicable.String
NatureLabelLabel describing company nature.String
ProductiveEntProductive enterprise indicator.String
ClassificationActivity classification codes.Array of objects { Type, Value, Label }
L4RegisteredRegistered address line 4.String
CityCity name.String
StateCodeRegion or state administrative code.String
ActivityPlacePlace where the main activity occurs.String
SpecificProductionSpecific production indicator.String
RangeLabelStaffCountStaff count range label.String
NicHeadquarterNIC identifier of the headquarters.String
ClassificationYearYear associated with the activity classification.String
MainActivityMethodMethod used to define the main activity.String
TurnOverCompany turnover (may be empty).String or Number
IncorporationDateEntDate of enterprise incorporation.String (YYYY-MM-DD)
StaffCountYearEntReference year for enterprise staff count.String
UrbanUnitNumberUrban unit code.String
StaffCountYearYear for staff count measurement.String
L7StandardizedStandardized address line 7.String
StaffCountEntEnterprise staff count.String
StoreTypeStore type classification.String
IncorporationDateCompany incorporation date.String (YYYY-MM-DD)
RangeLabelStaffCountEntStaff count range label for enterprise.String
StreetNumStreet number.String
RangeCodeStaffCountCode representing staff count range.String
L5StandardizedStandardized address line 5.String
MainActivityMain activity code (possibly concatenated).String
AuxiliaryActivityAuxiliary activity code.String
PoBoxPO box number.String
StreetTypeType of street (e.g., RUE, AVENUE).String
VatNumberVAT identification number.String
EmailCompany email address.String
StaffCountStaff count (generic field).String
L3RegisteredRegistered address line 3.String
L1RegisteredRegistered address line 1.String
UrbanUnitDptUrban unit departmental code.String
UrbanUnitRangeRange of the urban unit.String
L6StandardizedStandardized address line 6.String
OrigineOrigin of the company record.String
CompNumAdditional company number.String
CompanyCNameCommercial company name.String
HeadquarterIndicates if the record is the headquarters (1 = yes).String or Integer
L2StandardizedStandardized address line 2.String
ProductiveProductive establishment indicator.String
LastNameLast name of representative.String
NatureLastUpdate1 / NatureLastUpdate2 / NatureLastUpdate3Additional update nature indicators.String
DetailCityRangeDetailed city range code.String
MonoActivityIndicates if the company has a single activity.String
L5RegisteredRegistered address line 5.String
StateCodeEntEnterprise state/region code.String
CountyCounty code.String
L7RegisteredRegistered address line 7.String
ClassificationYearEntEnterprise classification year.String
LegalStructureLegal structure object list { Value, Label }.Array of objects
LongCompanyNameFull official company name.String
SocialSolidarityEconomyDateDate of entry into social solidarity economy.String
CityIdEnExtended city identifier.String
PublicCompCoopIntercomIntercommunal cooperation code.String
FirstActivityEntFirst declared enterprise activity.String
LastUpdateDate of last data update.String
MainActivityEntMain enterprise activity code.String
DistributionDateEntDistribution date for enterprise-level data.String

 

Example :

{
  "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": ""
    }
  ]
}

 

Error

Compressed form

Error typeRequestResponse type
Missing “Licence” parameterhttps://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA&Licece={LICENSE}{"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"}
Empty “Licence” parameterhttps://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA&Licence={"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"}
Error on a parameterhttps://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARH_REF=&Country=FRA&Licence={LICENSE}{"status": 400, "message": "Missing parameters", "details": "SEARCH_REF", "error": "bad request"}

 

Extended form

Error typeRequestResponse type
Missing “Licence” parameterhttps://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA&Licece={LICENSE}{"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"}
Empty 
“Licence” 
parameter
https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA&Licence={"status": 400, "message": "Missing parameters", "details": "Licence", "error": "bad request"}

 

Related to

Was this article helpful?

0 out of 0 found this helpful