-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcompany.openapi.json
More file actions
1 lines (1 loc) · 316 KB
/
Copy pathcompany.openapi.json
File metadata and controls
1 lines (1 loc) · 316 KB
1
{"openapi":"3.0.0","info":{"description":"This service provides REST calls to extract information on businesses and companies from VAT or TAX code (or other identifiers especially for non-European countries).\n\nBeyond Italy, there are endpoints targeting individual European countries like France, Germany, Spain, or the United Kingdom (and many others), or three endpoints that encompass a search for every country in the world.\n\nIn addition to synchronous information, there is also the ability to intercept any changes that occur within a company through the new monitoring section.\n\nAt this <a href='https://docs.openapi.it/company-sandbox-examples.html' target='_blank'>link</a> you can find a list of companies that allow you to try the service in a sandbox environment.","version":"1.0.0","title":"Company","termsOfService":"https://openapi.it/en/terms-and-conditions","contact":{"url":"https://openapi.it/en/support","name":"Support"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"servers":[{"url":"https://company.openapi.com","description":"Production"},{"url":"https://test.company.openapi.com","description":"Sandbox"}],"tags":[{"name":"IT","description":"Extraction of company information starting from VAT or TAX code. Reference country: Italy"},{"name":"EU","description":"Extraction of company information starting from VAT or TAX code. Reference area: Europe"},{"name":"FR","description":"Extraction of company information starting from VAT or Siret code. Reference area: France"},{"name":"DE","description":"Extraction of company information starting from VAT. Reference area: Germany"},{"name":"ES","description":"Extraction of company information starting from VAT. Reference area: Spain"},{"name":"PT","description":"Extraction of company information starting from VAT. Reference area: Portugal"},{"name":"GB","description":"Extraction of company information starting from VAT. Reference area: Great Britain"},{"name":"BE","description":"Extraction of company information starting from VAT. Reference area: Belgium"},{"name":"AT","description":"Extraction of company information starting from VAT. Reference area: Austria"},{"name":"CH","description":"Extraction of company information starting from VAT. Reference area: Switzerland"},{"name":"PL","description":"Extraction of company information starting from VAT. Reference area: Poland"},{"name":"WW","description":"Extraction of company information starting from VAT. Reference area: World Wide"},{"name":"Monitor","description":"Business information monitoring system. Reference area: World Wide"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Marketing":{"type":"object","properties":{"companyDetails":{"$ref":"#/components/schemas/companyDetails"},"companyStatus":{"$ref":"#/components/schemas/companyStatus"},"address":{"$ref":"#/components/schemas/address"},"branches":{"$ref":"#/components/schemas/branches"},"atecoClassification":{"$ref":"#/components/schemas/atecoClassification"},"internationalClassification":{"$ref":"#/components/schemas/internationalClassification"},"corporateGroups":{"$ref":"#/components/schemas/corporateGroups"},"employees":{"$ref":"#/components/schemas/employees"},"employeesStatistic":{"$ref":"#/components/schemas/employeesStatistic"},"innovativeSmeAndSu":{"$ref":"#/components/schemas/innovativeSmeAndSu"},"mail":{"$ref":"#/components/schemas/mail"},"contacts":{"$ref":"#/components/schemas/contacts"},"ecofin":{"$ref":"#/components/schemas/ecofin"},"webAndSocial":{"$ref":"#/components/schemas/webAndSocial"},"pec":{"$ref":"#/components/schemas/pec"},"allOffices":{"type":"array","items":{"type":"object","properties":{"companyDetails":{"$ref":"#/components/schemas/companyDetails"},"companyStatus":{"$ref":"#/components/schemas/companyStatus"},"address":{"$ref":"#/components/schemas/address"}}}}}},"Stakeholders":{"type":"object","properties":{"companyDetails":{"$ref":"#/components/schemas/companyDetails"},"address":{"$ref":"#/components/schemas/address"},"branches":{"$ref":"#/components/schemas/branches"},"managers":{"$ref":"#/components/schemas/managers"},"shareholders":{"$ref":"#/components/schemas/shareholders"},"corporateGroups":{"$ref":"#/components/schemas/corporateGroups"},"subsidiaries":{"$ref":"#/components/schemas/subsidiaries"},"affiliateCompanies":{"$ref":"#/components/schemas/affiliateCompanies"},"employees":{"$ref":"#/components/schemas/employees"},"employeesStatistic":{"$ref":"#/components/schemas/employeesStatistic"}}},"Aml":{"type":"object","properties":{"companyDetails":{"$ref":"#/components/schemas/companyDetails"},"address":{"$ref":"#/components/schemas/address"},"branches":{"$ref":"#/components/schemas/branches"},"managers":{"$ref":"#/components/schemas/managers"},"shareholders":{"$ref":"#/components/schemas/shareholders"},"corporateGroups":{"$ref":"#/components/schemas/corporateGroups"},"subsidiaries":{"$ref":"#/components/schemas/subsidiaries"},"affiliateCompanies":{"$ref":"#/components/schemas/affiliateCompanies"},"foreignTrade":{"$ref":"#/components/schemas/foreignTrade"},"publicTenders":{"$ref":"#/components/schemas/publicTenders"},"operatingResults":{"$ref":"#/components/schemas/operatingResults"},"ecofin":{"$ref":"#/components/schemas/ecofin"},"debts":{"$ref":"#/components/schemas/debts"},"rae":{"$ref":"#/components/schemas/rae"},"sae":{"$ref":"#/components/schemas/sae"}}},"Full":{"type":"object","properties":{"companyDetails":{"$ref":"#/components/schemas/companyDetails"},"legalForm":{"$ref":"#/components/schemas/legalForm"},"companyStatus":{"$ref":"#/components/schemas/companyStatus"},"companyDates":{"$ref":"#/components/schemas/companyDates"},"address":{"$ref":"#/components/schemas/address"},"marketable":{"$ref":"#/components/schemas/marketable"},"branches":{"$ref":"#/components/schemas/branches"},"atecoClassification":{"$ref":"#/components/schemas/atecoClassification"},"internationalClassification":{"$ref":"#/components/schemas/internationalClassification"},"ecofin":{"$ref":"#/components/schemas/ecofin"},"employees":{"$ref":"#/components/schemas/employees"},"operatingResults":{"$ref":"#/components/schemas/operatingResults"},"employeesStatistic":{"$ref":"#/components/schemas/employeesStatistic"},"innovativeSmeAndSu":{"$ref":"#/components/schemas/innovativeSmeAndSu"},"mail":{"$ref":"#/components/schemas/mail"},"contacts":{"$ref":"#/components/schemas/contacts"},"webAndSocial":{"$ref":"#/components/schemas/webAndSocial"},"pec":{"$ref":"#/components/schemas/pec"},"publicTenders":{"$ref":"#/components/schemas/publicTenders"},"foreignTrade":{"$ref":"#/components/schemas/foreignTrade"},"managers":{"$ref":"#/components/schemas/managers"},"shareholders":{"$ref":"#/components/schemas/shareholders"},"corporateGroups":{"$ref":"#/components/schemas/corporateGroups"},"subsidiaries":{"$ref":"#/components/schemas/subsidiaries"},"affiliateCompanies":{"$ref":"#/components/schemas/affiliateCompanies"},"artisanBusinessRegistry":{"$ref":"#/components/schemas/artisanBusinessRegistry"},"soaCertification":{"$ref":"#/components/schemas/soaCertification"},"assetsAggregateValues":{"$ref":"#/components/schemas/assetsAggregateValues"},"creditsToShareholders":{"$ref":"#/components/schemas/creditsToShareholders"},"intangibleFixedAssets":{"$ref":"#/components/schemas/intangibleFixedAssets"},"tangibleFixedAssets":{"$ref":"#/components/schemas/tangibleFixedAssets"},"financialFixedAssets":{"$ref":"#/components/schemas/financialFixedAssets"},"inventory":{"$ref":"#/components/schemas/inventory"},"credits":{"$ref":"#/components/schemas/credits"},"financialAssets":{"$ref":"#/components/schemas/financialAssets"},"cashEquivalents":{"$ref":"#/components/schemas/cashEquivalents"},"liabilitiesAggregateValues":{"$ref":"#/components/schemas/liabilitiesAggregateValues"},"netWorth":{"$ref":"#/components/schemas/netWorth"},"riskProvisions":{"$ref":"#/components/schemas/riskProvisions"},"debts":{"$ref":"#/components/schemas/debts"},"incomeStatementAggregateValues":{"$ref":"#/components/schemas/incomeStatementAggregateValues"},"productionValue":{"$ref":"#/components/schemas/productionValue"},"productionCosts":{"$ref":"#/components/schemas/productionCosts"},"revenuesFinancialCharges":{"$ref":"#/components/schemas/revenuesFinancialCharges"},"adjustments":{"$ref":"#/components/schemas/adjustments"},"annualResult":{"$ref":"#/components/schemas/annualResult"},"coverageRatios":{"$ref":"#/components/schemas/coverageRatios"},"development":{"$ref":"#/components/schemas/development"},"efficiency":{"$ref":"#/components/schemas/efficiency"},"financialBurden":{"$ref":"#/components/schemas/financialBurden"},"financialCycle":{"$ref":"#/components/schemas/financialCycle"},"financialStability":{"$ref":"#/components/schemas/financialStability"},"financialStatementKpi":{"$ref":"#/components/schemas/financialStatementKpi"},"indebtedness":{"$ref":"#/components/schemas/indebtedness"},"leverageRatios":{"$ref":"#/components/schemas/leverageRatios"},"liquidityRatios":{"$ref":"#/components/schemas/liquidityRatios"},"profitability":{"$ref":"#/components/schemas/profitability"},"structureRatios":{"$ref":"#/components/schemas/structureRatios"},"rae":{"$ref":"#/components/schemas/rae"},"sae":{"$ref":"#/components/schemas/sae"},"allOffices":{"type":"array","items":{"type":"object","properties":{"companyDetails":{"$ref":"#/components/schemas/companyDetails"},"companyStatus":{"$ref":"#/components/schemas/companyStatus"},"address":{"$ref":"#/components/schemas/address"}}}}}},"companyDetails":{"type":"object","properties":{"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"lastUpdateDate":{"type":"string","format":"date-time","description":"Latest update of Company Data"},"cciaa":{"type":"string","description":"Acronym of the city where the company was registered (e.g. RM as Rome, MI as Milan etc.)"},"reaCode":{"type":"string","description":"Economic and Administrative Repertory number for Chamber of Commerce"},"openapiNumber":{"type":"string","description":"Internal identification number"},"companyName":{"type":"string","description":"Legal name of the company"},"officeType":{"type":"object","properties":{"code":{"type":"string","description":"Office type code","enum":["SSL","SL","UL","S","D"]},"description":{"type":"string","description":"Office type description","enum":["Administrative headquarter and registered office","Registered office","Local units","Administrative headquarter","Division"]}}}}},"address":{"type":"object","properties":{"streetName":{"type":"string","description":"Name of the street where the office is located"},"zipCode":{"type":"string","description":"ZIP code (Italian CAP) where the office is located"},"town":{"type":"string","description":"Town where the office is located"},"province":{"type":"object","properties":{"code":{"type":"string","description":"County (Province) where the office is located"},"description":{"type":"string","description":"Complete name of the area (Province) where the office is located"}}},"region":{"type":"object","properties":{"code":{"type":"string","description":"Code Area (Region) where the office is located"},"description":{"type":"string","description":"Complete name of the area (Region) where the office is located"}}},"country":{"type":"object","properties":{"code":{"type":"string","description":"Code country where the office is located"},"description":{"type":"string","description":"Complete name of the country where the office is located"}}}}},"branches":{"type":"object","properties":{"numberOfBranches":{"type":"integer","description":"Number of branches"}}},"managers":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","description":"First name of the manager"},"surname":{"type":"string","description":"Surname of the manager"},"roles":{"type":"array","items":{"type":"object","properties":{"role":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["ASSSC","CAG","CES","COMC","DAQ","SOVRC","TI2","VPE","DS","IS","LUL","MASC","MCA","MGD","MINC","MSD","OPC","PCT","PG","RABBC","RAF","RAS","RC","PA0004","PA0034","PA0036","PA0050","PA0058","997997","ACR","C07","C11","COD","COMAC","CZ","DEPC","DI","SCR","SFI","SOC","SOP","STE","VCD","VDT","IMR","IN","PCO","PCS","PRA","PRE","RG","PA0010","PA0013","PA0020","PA0025","PA0029","PA0046","PA0052","PA0053","PA0059","AFF","ALLC","AMMIRC","AUP","C03","C19","COF","CUF","DIA","SOL","SQU","VCA","VDA","VICC","VIV","DL2","DLF","DRE","EXS","GER","LRF","MCS","MDC","OCO","ODI","OES","PDI","PS","QUEC","PA0005","PA0012","PA0018","PA0021","PA0030","PA0048","888888","AUN","C12","CAD","CEP","CF","CLD","COE","CON","COS","CPC","CU","DEP","SDR","SIE","SIP","TES","VDS","VPP","DSC","LGR","MCE","MPP","PF","PP","PRO","PRS","PRT","PSE","PTT","RAP","RECC","PA0001","PA0049","CMS","COP","COZ","CSG","DIVC","SAP","SNC","SOA","SPR","TESC","TU","US","DMKC","FU","GOV","GSG","KY","LI","LR2","MS","PCE","PDC","PDS","PE","PEP","PPP","PRP","PRSD","RE","PA0002","PA0032","PA0041","PA0044","PA0056","AF","CCG","CG","CGS","COA","COO","DCP","DE","SDRC","SOU","DRC","DRR","ELE","FC","LGT","LSA","MCD","MI","OPN","PARC","PASC","PB","PCD","PFT","PGD","PM","PRC","PRQ","PTR","RCF","RETEC","PA0009","PA0016","PA0060","PA0062","PA0063","AMBC","ASSC","C02","C09","C22","C28","CC","CI","CLR","CM","CNG","COLLC","CTE","DAM","DCO","DIV","RV","SFC","SLA","SLR","SQ","TTE","VDI","VID","MED","MGS","PSC","PT","RES","RETC","RIT","PA0003","PA0006","PA0022","PA0026","PA0028","AMM","AMS","ARVC","C08","C16","C26","CD","CDS","CDT","CONC","CPR","CUM","DAQC","DIR","SNA","SNQ","VDC","VIC","DP","DPC","GID","IMN","LRT","MA","MCT","MGC","PC","PCG","PCP","PEO","PTE","RAZ","RCD","RPS","PA0007","PA0038","PA0054","PAR","999999","ASO","C21","CE","COL","COV","CS","CSMC","CST","CUV","DA","DF","VICPREFC","VSC","VSG","DNC","DR","DTC","MP","PSS","LIG","MCG","MGE","OCA","PGT","PL","PN","RCS","PA0027","PA0039","PA0061","RTE","992992","998998","ADP","AMG","APR","ART","C15","C17","C23","C32","C34","CT","CUE","DG","RSU","SEGC","SNP","SOR","UM1","VAD","VCG","VGD","VPA","KV","LER","MA_","OAS","PA","PCV","PES","PGS","PR","PTS","RCO","RFM","PA0008","PA0014","PA0015","PA0023","PA0040","PADC","996996","ACP","AMP","ATI","C13","C14","C18","C20","CDG","CLT","COM","CRT","CSA","DAC","DC","DEC","DES","RSS","RTC","SAB","SEP","SOF","SOS","TPS","UM2","VDE","VGE","VGO","VICPRC","DMK","DT","FAT","NE","OPA","PCA","PGC","PGE","RDF","RIN","PA0011","PA0019","PA0033","PA0035","PA0051","PA0055","PA0057","ND99","AMD","C01","C29","CA","CAPC","CDP","CGE","COG","COLLDC","COT","CSS","CVE","DGC","DIP","SA","SCA","SIS","SON","SOT","TI","TIT","VCO","VDG","VED","VESC","VSD","DRG","DSA","DTD","DZ","GE","IG","PAD","PAF","PCM","PED","PGF","PGM","PPR","PREC","PROVC","PSD","RA","PA0017","PA0024","PA0031","PA0037","PA0042","PA0043","PA0045","PA0047","RTA"]},"description":{"type":"string","description":"Role description of the manager in the company"}}},"roleStartDate":{"type":"string","format":"date-time","description":"Starting date of the manager's role in the company. The start date field corresponds to the Registration Date in this order of priority date of registration, date of entry in the register of members, date of deed of appointment"}}}},"gender":{"type":"object","properties":{"code":{"type":"string","description":"Gender code (M/W)","enum":["M","W"]},"description":{"type":"string","description":"Gender Description (Man/Woman)"}}},"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"birthDate":{"type":"string","format":"date-time","description":"Date of birth of the manager"},"age":{"type":"integer","description":"Manager's age"},"birthTown":{"type":"string","description":"Town of birth of the manager"},"isLegalRepresentative":{"type":"boolean","description":"The field indicates if the manager is also the legal representative of the company (true / false)"}}},{"type":"object","properties":{"companyName":{"type":"string","description":"Legal name of the company"},"roles":{"type":"array","items":{"type":"object","properties":{"role":{"type":"object","properties":{"code":{"type":"string","description":"Role code of the manager in the company"},"description":{"type":"string","description":"Role description of the manager in the company"}}},"roleStartDate":{"type":"string","format":"date-time","description":"Starting date of the manager's role in the company. The start date field corresponds to the Registration Date in this order of priority date of registration, date of entry in the register of members, date of deed of appointment"}}}},"taxCode":{"type":"string","description":"Tax code of manager"},"isLegalRepresentative":{"type":"boolean","description":"The field indicates if the manager is also the legal representative of the company (true / false)"}}}]}},"shareholders":{"type":"array","items":{"type":"object","properties":{"shareholdersInformation":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code of shareholder"},"name":{"type":"string","description":"First Name of the shareholder"},"surname":{"type":"string","description":"Surname of the shareholder"},"streetName":{"type":"string","description":"Address of the shareholder's domicile"},"sinceDate":{"type":"string","format":"date-time","description":"Starting date of the shareholder's role in the company"},"zipCode":{"type":"string","description":"Zip code of the shareholder's domicile"},"town":{"type":"string","description":"Town of the shareholder's domicile"}}},{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code of shareholder"},"openapiNumber":{"type":"string","description":"Internal identification number"},"companyName":{"type":"string","description":"Company name"},"sinceDate":{"type":"string","format":"date-time","description":"Starting date of the shareholder's role in the company"},"streetName":{"type":"string","description":"Domicile address (for a private person) or registered office (for a company)"},"zipCode":{"type":"string","description":"Zip code of the shareholder's registered office"},"town":{"type":"string","description":"Town of the shareholder's registered office"}}}]}},"percentShare":{"type":"number","format":"double","description":"Percentage ownership of the company (%)"}}}},"corporateGroups":{"type":"object","properties":{"belongsToGroup":{"type":"boolean","description":"The field indicates whether the company is part of a Corporate"},"groupName":{"type":"string","description":"Name of corporate group"},"holdingCompanyName":{"type":"string","description":"Name of holding company"},"holdingCountry":{"type":"object","properties":{"code":{"type":"string","description":"Code for the country where the holding company is located"},"description":{"type":"string","description":"Country where the holding company is based"}}},"nationalParentCompany":{"type":"object","properties":{"companyName":{"type":"string","description":"Name of parent company"},"streetName":{"type":"string","description":"Address of the headquarters of the parent company"},"town":{"type":"string","description":"Town of the headquarters of the parent company"},"zipCode":{"type":"string","description":"Zip Code of the headquarters of the parent company"},"province":{"type":"object","properties":{"code":{"type":"string","description":"Code Area (Province) where the headquarters of the parent company is based"},"description":{"type":"string","description":"Description of Area (Province) where the headquarters of the parent company is based"}}},"country":{"type":"object","properties":{"code":{"type":"string","description":"Country Code where the headquarters is based"},"description":{"type":"string","description":"Country where the headquarters is based"}}}}},"hasForeignParentCompany":{"type":"boolean","description":"The field indicates if the parent company is abroad (true/false)"}}},"subsidiaries":{"type":"array","items":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code of subsidiary company"},"companyName":{"type":"string","description":"Name of subsidiary company"},"streetName":{"type":"string","description":"Address of subsidiary company"},"zipCode":{"type":"string","description":"ZipCode of subsidiary company"},"town":{"type":"string","description":"Town of subsidiary company"},"province":{"type":"object","properties":{"code":{"type":"string","description":"Code Area (Province) of subsidiary company"},"description":{"type":"string","description":"Area (Province) of subsidiary company"}}}}}},"affiliateCompanies":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code of affiliate company"},"companyName":{"type":"string","description":"Name of affiliate company"},"percentShare":{"type":"number","format":"double","description":"Percentage of the affiliated company"}}},"foreignTrade":{"type":"object","properties":{"isImporter":{"type":"boolean","description":"The field indicates whether the company imports from abroad (true/false). The information on import has been sourced from interviews, so the % figure was provided by the company"},"importPercentShare":{"type":"integer","description":"Percentage of imported goods"},"importCountries":{"type":"string","description":"Name of the countries from where the company imports"},"isExporter":{"type":"boolean","description":"The field indicates whether the company exports abroad (true/false). Information on export has either an interview source or a note source"},"exportPercentShare":{"type":"integer","description":"Percentage of goods exported"},"exportCountries":{"type":"string","description":"Name of the countries where the company exports"}}},"publicTenders":{"type":"array","items":{"type":"object","properties":{"year":{"type":"string","description":"This field indicates the last year of participation in public tenders"},"applied":{"type":"integer","description":"This field shows how many public tenders the company has participated in"},"won":{"type":"integer","description":"This field shows how many public tenders the company won"},"value":{"type":"number","format":"double","description":"This field indicates the value of public tenders won by the company"}}}},"operatingResults":{"type":"object","properties":{"ebitda":{"type":"number","format":"double","description":"EBITDA stands for Earning Before Interest Tax Depreciation Amortisation and is synonymous with Gross Operating Margin (GOP) (in italian Margine Operativo Lordo - MOL) . It is an indicator of profitability and represents earnings before financial expenses, taxes, depreciation and amortisation. EBITDA is calculated: Production value - Cost of raw materials - Cost of services - Personnel costs - Operating costs"},"ebitdaL2Y":{"type":"number","format":"double","description":"EBITDA with reference to the last 2 years"},"ebit":{"type":"number","format":"double","description":"EBIT stands for Earnings Before Interests and Taxes (in italian Risultato Operativo o Margine operativo Netto - MON) and is an indicator for assessing the profitability of a company. EBIT is the margin produced by the activity without considering financial charges and taxes. EBIT is the result of EBITDA - Operating costs including depreciation"},"ebitL2Y":{"type":"number","format":"double","description":"EBIT with reference to the last 2 years"},"cashFlow":{"type":"number","format":"double","description":"Cash flow indicates the positive or negative changes in the company's liquidity that occur in a year"},"cashFlowL2Y":{"type":"number","format":"double","description":"Cash flow indicates the positive or negative changes in the company's liquidity that occur in the last two years"}}},"ecofin":{"type":"object","properties":{"balanceSheetDate":{"type":"string","format":"date-time","description":"Date of submission of the last balance sheet"},"turnoverRange":{"type":"object","properties":{"code":{"type":"string","description":"Turnover range code"},"description":{"type":"string","description":"Turnover range (e.g. 1000000 - 4999999)"}}},"turnoverYear":{"type":"integer","description":"Reference year of turnover"},"turnover":{"type":"number","format":"double","description":"Amount of turnover"},"turnoverTrend":{"type":"number","format":"double","description":"The turnover trend is the growth in turnover in the last available year compared to the previous year"},"shareCapital":{"type":"number","format":"double","description":"The amount of share capital"},"netWorth":{"type":"number","format":"double","description":"The amount of net worth"},"enterpriseSize":{"type":"object","properties":{"code":{"type":"string","description":"Enterprise size range code"},"description":{"type":"string","description":"Company size descriptions (e.g. Small enterprise)"}}}}},"debts":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC116","IIC117","IIC090","IIC091","IIC329","IIC092","IIC093","IIC330","IIC184","IIC185","IIC331","IIC094","IIC095","IIC332","IIC096","IIC097","IIC333","IIC098","IIC099","IIC334","IIC100","IIC101","IIC335","IIC102","IIC103","IIC336","IIC104","IIC105","IIC337","IIC106","IIC107","IIC338","IIC108","IIC109","IIC339","IIC220","IIC221","IIC340","IIC110","IIC111","IIC341","IIC112","IIC113","IIC342","IIC114","IIC115","IIC343"]},"value":{"type":"number","format":"double"}}},"companyStatus":{"type":"object","properties":{"activityStatus":{"type":"object","properties":{"code":{"type":"string","description":"Company Status Code","enum":["A","CF","CS","I","IF","IS","S"]},"description":{"type":"string","description":"Business status of the company (e.g. Enable)","enum":["Enable","Out of business (in a positive way)","Out of business (in a negative way)","Inactive","In closure (in a positive way)","In closure (in a negative way)","Dormant"]}}}}},"atecoClassification":{"type":"object","properties":{"ateco":{"type":"object","properties":{"code":{"type":"string","description":"First level 2025 ATECO code (an italian classification system for economic activities) and is communicated to the Revenue Agency (Agenzia delle Entrate) when opening a VAT number and thus creating a new company. The 2025 Ateco code is an alphanumeric combination that identifies an economic activity. The letters identify the economic macro-sector while the numbers (two to six digits) represent, with varying degrees of detail, the specific subcategories of the sectors themselves. Economic activities are grouped in increasing detail according to: Sections (1 letter), Divisions (2-digit number), Groups (3-digit number), Classes (4-digit number), Categories (5-digit number), Subcategories (6-digit number). The 2025 ATECO code can be changed by the company but must always be communicated to the Revenue Agency"},"description":{"type":"string","description":"Description of the first level 2025 ATECO Code"}}},"secondaryAteco":{"type":"string","description":"Secondary level 2025 ATECO code. Enterprises carrying out several economic activities may have a primary and a secondary 2025 ATECO code. The primary indicates the predominant activity. The secondary specifies the other nature of the services offered"},"ateco2022":{"type":"object","properties":{"code":{"type":"string","description":"First level 2022 ATECO code (an italian classification system for economic activities) and is communicated to the Revenue Agency (Agenzia delle Entrate) when opening a VAT number and thus creating a new company. The 2022 Ateco code is an alphanumeric combination that identifies an economic activity. The letters identify the economic macro-sector while the numbers (two to six digits) represent, with varying degrees of detail, the specific subcategories of the sectors themselves. Economic activities are grouped in increasing detail according to: Sections (1 letter), Divisions (2-digit number), Groups (3-digit number), Classes (4-digit number), Categories (5-digit number), Subcategories (6-digit number). The 2022 ATECO code can be changed by the company but must always be communicated to the Revenue Agency"},"description":{"type":"string","description":"Description of the first level 2022 ATECO Code"}}},"secondaryAteco2022":{"type":"string","description":"Secondary level 2022 ATECO code. Enterprises carrying out several economic activities may have a primary and a secondary 2022 ATECO code. The primary indicates the predominant activity. The secondary specifies the other nature of the services offered"}}},"internationalClassification":{"type":"object","properties":{"primarySic":{"type":"object","properties":{"code":{"type":"string","description":"Primary SIC code (a classification system for economic activities in U.S.A.) The classification system uses four-digit coded numbers that categorize businesses by industry. The first two digits classify the major group. The third digit further defines the industry group. The last digit indicates the industry sector. Every business can be categorized with a SIC code"},"description":{"type":"string","description":"Description of Primary SIC code (a classification system for economic activities in U.S.A.)"}}},"secondarySic":{"type":"string","description":"Description of Secondary SIC code (a classification system for economic activities in U.S.A.). Businesses can also have up to five secondary SIC codes. Secondary SIC codes classify other industries the business is involved in but aren't the main focus"}}},"employees":{"type":"object","properties":{"employeeRange":{"type":"object","properties":{"code":{"type":"string","description":"Code for the range of the number of employees"},"description":{"type":"string","description":"Range of the number of employees"}}},"employee":{"type":"integer","description":"Amount of Employees"},"employeeTrend":{"type":"integer","description":"The employee trend is the growth in the number of employees in the current year compared to the previous year (%)"}}},"employeesStatistic":{"type":"object","properties":{"fixedTermContract":{"type":"number","format":"double","description":"Percentage of employees with fixed-term contracts (italian contratto a tempo determinato)"},"permanentContract":{"type":"number","format":"double","description":"Percentage of employees with permanent contracts (italian contratto a tempo indeterminato)"},"partialTimeContract":{"type":"number","format":"double","description":"Percentage of employees with partial time contract (italian contratto a tempo parziale)"},"fullTimeContract":{"type":"number","format":"double","description":"Percentage of employees with full time contract (italian contratto a tempo pieno)"},"director":{"type":"number","format":"double","description":"Percentage of employees with a corporate role: director (in italian dirigente)"},"frameworkContract":{"type":"number","format":"double","description":"Percentage of employees with a corporate role: framework contract (in italian quadro)"},"whiteCollar":{"type":"number","format":"double","description":"Percentage of employees with a corporate role: white-collar (in italian impiegato)"},"apprentice":{"type":"number","format":"double","description":"Percentage of employees with a corporate role: apprentice (in italian apprendistato)"}}},"innovativeSmeAndSu":{"type":"object","properties":{"isInnovativeStartUp":{"type":"boolean","description":"The field indicates if the company is an innovative startup (true / false), a special section of Italian Chamber of Commerce registry"},"isInnovativeSme":{"type":"boolean","description":"The field indicates if the company is an innovative SME (true / false) a special section of Italian Chamber of Commerce registry"}}},"mail":{"type":"object","properties":{"email":{"type":"string","description":"Company email (e.g. info@company.com)"}}},"contacts":{"type":"object","properties":{"telephoneNumber":{"type":"string","description":"Company telephone number"},"fax":{"type":"string","description":"Company Fax number"}}},"webAndSocial":{"type":"object","properties":{"hasSocial":{"type":"boolean","description":"Social"},"eCommerce":{"type":"string","description":"E-Commerce URL"},"website":{"type":"string","description":"Website URL"},"facebook":{"type":"string","description":"URL of the company's Facebook page"},"youtube":{"type":"string","description":"URL of the company's YouTube channel"},"twitter":{"type":"string","description":"URL of the company's Twitter profile"},"instagram":{"type":"string","description":"URL of the company's Instagram profile"},"linkedin":{"type":"string","description":"URL of the company's LinkedIn profile"},"pinterest":{"type":"string","description":"URL of the company's Pinterest profile"},"vimeo":{"type":"string","description":"URL of the company's Vimeo channel"}}},"pec":{"type":"string","description":"Company PEC address (Italian Registred Certified Email)"},"legalForm":{"type":"object","properties":{"legalForm":{"type":"object","properties":{"code":{"type":"string","description":"Code for the legal category of the company: SC (for 'Joint Stock Company', in English Joint Stock Business) - AL (for 'Company of Other Forms', in English Company of Other Forms) - SP (for 'Partnership', in English Partnership)","enum":["SC","AL","SP"]},"description":{"type":"string","description":"Full name of the legal category of the company: Joint stock business (in Italian Società di Capitali - code SC), Company of Other Forms (in Italian Società di Altre Forme, code AL ), Partnership (for 'Società di Persone', code SP)"}}},"detailedLegalForm":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["AA","AC","AE","AF","AI","AL","AM","AN","AP","AR","AS","AT","AU","AZ","CC","CE","CF","CI","CL","CM","CN","CO","CR","CS","CZ","DI","EC","ED","EE","EI","EL","EM","EN","EP","ER","ES","FI","FO","GE","IC","ID","IF","IR","LL","MA","OC","OO","OS","PA","PC","PF","PS","RC","RR","RS","SA","SC","SD","SE","SF","SG","SI","SL","SM","SN","SO","SP","SR","SS","ST","SU","SV","SZ","XX"]},"description":{"type":"string","description":"Full name of the legal form of the company"}}}}},"companyDates":{"type":"object","properties":{"registrationDate":{"type":"string","format":"date-time","description":"Chamber of Commerce registration date: the date on which the company is registered with the Chamber of Commerce, this date may change whenever the company moves and changes"},"startDate":{"type":"string","format":"date-time","description":"Date on which the company actually starts operating"},"incorporationDate":{"type":"string","format":"date-time","description":""},"foundingDate":{"type":"string","format":"date-time","description":"The date on which the company was formed"},"endDate":{"type":"string","format":"date-time","description":"Date of termination of the company"}}},"marketable":{"type":"object","properties":{"isMarketable":{"type":"boolean","description":"The Marketable field identifies companies in business, i.e. the set of companies that have not ceased trading and are not closing"}}},"artisanBusinessRegistry":{"type":"object","properties":{"belongsToArtisanBusinessRegistry":{"type":"boolean","description":"This field indicates whether the company is registered in the special register Artisan in the chamber of commerce"},"artisanBusinessRegistry":{"type":"object","properties":{"registrationDate":{"type":"string","format":"date-time","description":"Date of registration in the special register Artisan in the Chamber of Commerce"},"registrationNumber":{"type":"string","description":"Numer of registration in the special register Artisan in the Chamber of Commerce"}}}}},"soaCertification":{"type":"object","properties":{"hasSoaCertification":{"type":"boolean","description":"This field indicates whether the company has SOA certification (true/false)"}}},"assetsAggregateValues":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC001","IIC039","IIC071","IIC072","IIC073","IIC074"]},"value":{"type":"number","format":"double"}}},"creditsToShareholders":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC193","IIC002"]},"value":{"type":"number","format":"double"}}},"intangibleFixedAssets":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC011","IIC003","IIC004","IIC005","IIC006","IIC007","IIC008","IIC009","IIC010"]},"value":{"type":"number","format":"double"}}},"tangibleFixedAssets":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC018","IIC012","IIC013","IIC014","IIC015","IIC016","IIC017"]},"value":{"type":"number","format":"double"}}},"financialFixedAssets":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC038","IIC032","IIC033","IIC023","IIC019","IIC020","IIC021","IIC194","IIC022","IIC034","IIC024","IIC025","IIC316","IIC026","IIC027","IIC317","IIC028","IIC029","IIC318","IIC195","IIC196","IIC319","IIC030","IIC031","IIC320","IIC035","IIC036","IIC037","IIC197","IIC344"]},"value":{"type":"number","format":"double"}}},"inventory":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC045","IIC040","IIC041","IIC042","IIC043","IIC044","IIC349"]},"value":{"type":"number","format":"double"}}},"credits":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC058","IIC056","IIC057","IIC046","IIC047","IIC321","IIC048","IIC049","IIC322","IIC050","IIC051","IIC323","IIC052","IIC053","IIC324","IIC198","IIC199","IIC325","IIC180","IIC181","IIC326","IIC054","IIC055","IIC328","IIC182","IIC183","IIC327"]},"value":{"type":"number","format":"double"}}},"financialAssets":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC066","IIC059","IIC060","IIC061","IIC200","IIC062","IIC063","IIC064","IIC201","IIC065","IIC202"]},"value":{"type":"number","format":"double"}}},"cashEquivalents":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC070","IIC067","IIC068","IIC069"]},"value":{"type":"number","format":"double"}}},"liabilitiesAggregateValues":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC084","IIC088","IIC089","IIC118","IIC119","IIC120","IIC121","IIC122","IIC123"]},"value":{"type":"number","format":"double"}}},"netWorth":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC075","IIC076","IIC077","IIC078","IIC079","IIC080","IIC081","IIC082","IIC083","IIC203","IIC204","IIC205","IIC206","IIC207","IIC208","IIC209","IIC210","IIC211","IIC212","IIC213","IIC345","IIC214","IIC215","IIC216","IIC218"]},"value":{"type":"number","format":"double"}}},"riskProvisions":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC085","IIC086","IIC219","IIC087"]},"value":{"type":"number","format":"double"}}},"incomeStatementAggregateValues":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC130","IIC149","IIC224","IIC161","IIC170","IIC176"]},"value":{"type":"number","format":"double"}}},"productionValue":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC124","IIC125","IIC126","IIC186","IIC127","IIC128","IIC129","IIC223"]},"value":{"type":"number","format":"double"}}},"productionCosts":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC131","IIC132","IIC133","IIC139","IIC134","IIC135","IIC136","IIC137","IIC138","IIC187","IIC144","IIC140","IIC141","IIC142","IIC188","IIC143","IIC145","IIC146","IIC147","IIC148"]},"value":{"type":"number","format":"double"}}},"revenuesFinancialCharges":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC150","IIC151","IIC225","IIC226","IIC227","IIC228","IIC229","IIC158","IIC152","IIC153","IIC230","IPL231","IPL232","IIC233","IIC234","IIC154","IIC155","IIC189","IIC156","IIC157","IIC235","IIC236","IIC237","IIC238","IIC239","IIC159","IIC160","IIC240","IIC241","IIC242","IIC243","IIC244","IIC190"]},"value":{"type":"number","format":"double"}}},"adjustments":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC165","IIC162","IIC163","IIC164","IIC245","IIC350","IIC169","IIC166","IIC167","IIC168","IIC246","IICC351"]},"value":{"type":"number","format":"double"}}},"annualResult":{"type":"object","properties":{"code":{"type":"string","description":"<a href='https://docs.openapi.it/company-legend.html' target='_blank'>Here</a> you can find the description of the various codes.","enum":["IIC171","IIC172","IIC173","IIC175","IIC174","IIC177","IIC178","IIC191","IIC347","IIC192","IIC250","IIC179"]},"value":{"type":"number","format":"double"}}},"coverageRatios":{"type":"object","properties":{"ebitdaNetInterestCoverage":{"type":"number","format":"double","description":"The EBITDA-to-interest coverage ratio is a financial ratio that is used to assess a company's financial durability. A ratio greater than 1 indicates that the company has more than enough interest coverage to pay off its interest expenses. EBITDA Net Interest Coverage is the result of EBITDA / ( financial expenses - total other income)"},"ffoNetInterestCoverage":{"type":"number","format":"double","description":"FFO Net Interest Coverage is the result of (Funds From Operations-Net Interest Paid) / (-Net Interest Paid)"},"ebitNetInterestCoverage":{"type":"number","format":"double","description":"The interest coverage ratio is a debt and profitability ratio used to determine how easily a company can pay interest on its outstanding debt. When a company's interest coverage ratio is only 1.5 or lower, its ability to meet interest expenses may be questionable. EBIT Net Interest Coverage is the result of EBIT / (Financial expenses - Total other income)"},"ebitdaGrossInterestCoverage":{"type":"number","format":"double","description":"The EBITDA-to-interest coverage ratio is a financial ratio that is used to assess a company's financial durability. A ratio greater than 1 indicates that the company has more than enough interest coverage to pay off its interest expenses. EBITDA Net Interest Coverage is the result of EBITDA / ( financial expenses - total other income)"},"ebitGrossInterestCoverage":{"type":"number","format":"double","description":"The interest coverage ratio is a debt and profitability ratio used to determine how easily a company can pay interest on its outstanding debt. When a company's interest coverage ratio is only 1.5 or lower, its ability to meet interest expenses may be questionable. EBIT Gross Interest Coverage is the result of EBIT / Financial Charges"}}},"development":{"type":"object","properties":{"ebitVariation":{"type":"number","format":"double","description":"Percentage change in EBITDA compared to the previous year (%)"},"grossFinancialDebt":{"type":"number","format":"double","description":"The percentage of change in gross financial debt compared to the previous year (%)"},"totalAssets":{"type":"number","format":"double","description":"The percentage of change in total assets (%)"},"mol":{"type":"number","format":"double","description":"The percentage change in EBITDA compared to the previous year (%)"},"addedValue":{"type":"number","format":"double","description":"The percentage of change in added value compared to the previous year (%)"},"productionValue":{"type":"number","format":"double","description":"The percentage of change in production value compared to the previous year (%)"}}},"efficiency":{"type":"object","properties":{"turnoverIndex":{"type":"number","format":"double","description":"The turnover index measures the efficiency with which a company uses its resources to produce sales and specifically, the indicator expresses the average revenue per unit of investment. The turnover index is the result Value of Production / Total Assets"},"inventoryRotation":{"type":"number","format":"double","description":"The inventory rotation measures the efficiency of inventory management by relating sales revenues to closing inventories.Inventory rotation is the result of Value of Production / Inventories"},"currentAssetsRotation":{"type":"number","format":"double","description":"The current assets rotation indicates the ability to renew working capital to be used for new production. Current Assets Rotation is the result of value of production / current assets"},"accountsReceivableRotation":{"type":"number","format":"double","description":"Rotation of accounts receivables measures the speed at which receivables from sales are returned in liquid form. Rotation of accounts receivables is the result of Value of Production / Receivables from customers"}}},"financialBurden":{"type":"object","properties":{"rod":{"type":"number","format":"double","description":"ROD (Return On Debt), is a balance sheet index that measures the value, in percentage terms, of the return on borrowed capital. ROD is the result of Financial Expense/Total Debt (%)"},"rodFinanziario":{"type":"number","format":"double","description":"Financial ROD (Return On Debt), is the result of Financial Expenses / (Bank Debts + Debts to Other Lenders) (%)"},"burdenIndex":{"type":"number","format":"double","description":""}}},"financialCycle":{"type":"object","properties":{"accountsReceivableDuration":{"type":"number","format":"double","description":"Accounts receivable duration (days) gives an average indication of the time (in days) elapsed between the time of sale and collection. It is the result of (Customer receivables / Value of Production ) * 365 (days)"},"stockDuration":{"type":"number","format":"double","description":"Stock duration indicates the time, in days, required for the investment in stock to become available to the company in liquid form. Stock duration is the result of (Inventories / Value of Production) * 365 (days)"},"debtsToSuppliersDuration":{"type":"number","format":"double","description":"Debts to suppliers duration provides an indication of the average length of time the company has been granted to defer payment by its suppliers, i.e. the number of days between the purchase of goods and services and their payment. Debts to suppliers duration is the result of (Debts to suppliers/(Purchases of materials + Services + Use of third party assets) * 365 (days)"},"financialCycleDuration":{"type":"number","format":"double","description":"Financial cycle duration (days) is the result of duration of customer receivables + duration of inventories - duration of supplier payables (days)"}}},"financialStability":{"type":"object","properties":{"secondaryMarginStructure":{"type":"number","format":"double","description":"Secondary/allocated structure margin measures a company's soundness through its ability to finance fixed assets through sustainable debt. A positive or breakeven secondary structure margin index shows a satisfactory correlation between medium- or long-term sources of financing and equally medium- or long-term investments. A negative ratio, on the other hand, indicates that fixed assets are not only covered by equity but also by a portion of current liabilities, which could mean that the company will face financial solvency problems in the short term. Secondary/Extended Structure Margin is the result of Shareholders' Equity + Medium-Long-Term Debts - Fixed Assets"},"marginStructure":{"type":"number","format":"double","description":"Structure Margin measures the company's ability to invest in its fixed assets through the capital paid in by its shareholders. Structure Margin is the result of Equity - Fixed Assets"},"fixedAssetsCoverageRate":{"type":"number","format":"double","description":"Fixed Assets Coverage Rate is an equity indicator used to show the balance between equity and fixed investments. Fixed Assets Coverage Rate is the result of (Equity + Medium/Long-term Debt) / Fixed Assets (%)"},"marginStructureIndex":{"type":"number","format":"double","description":"Structure Margin Index is the result of Equity / Fixed Assets"},"workingCapitalCoverage":{"type":"number","format":"double","description":"Working Capital Coverage measures your company's ability to generate cash from its operating activities and is the result of Net Working Capital (NWC) / Production value"},"acidTest":{"type":"number","format":"double","description":"Acid Test measures the company's ability to meet short-term commitments using only current assets net of inventories. The Immediate Liquidity Ratio is the result of (Current Assets-Revenues) / Current Liabilities"},"currentRatio":{"type":"number","format":"double","description":"Current ratio shows the company's ability to meet short-term commitments using only current assets. A value above 1 indicates that the company is potentially able to meet its short-term commitments without affecting its financial structure and resorting to alternative sources of debt. Values below 1 indicate a potentially difficult situation in the short term. Current ratio is the result of Current Assets/Current Liabilities"}}},"financialStatementKpi":{"type":"object","properties":{"debtsTurnover":{"type":"number","format":"double","description":"The Debts Turnover Ratio (also called as Receivables Turnover Ratio) shows how quickly the credit sales are converted into cash and measures the efficiency of a firm in managing and collecting the credit issued to customers. It is an activity ratio that finds out the relationship between credit sales and average trade receivables of a business"},"totalInventoryTurnover":{"type":"number","format":"double","description":"The inventory turnover ratio is the number of times a business sells and replaces its stock of goods during a given period. It considers the cost of goods sold, relative to its average inventory for a year or in any set period of time"}}},"indebtedness":{"type":"object","properties":{"bankDebtTotalAssets":{"type":"number","format":"double","description":"Total-debt-to-total-assets is a leverage ratio that defines how much debt a company owns compared to its assets"},"grossFinancialDebtTotalAssets":{"type":"number","format":"double","description":"Gross Financial Debt Total Assets is the result of Gross financial debt / Total Assets"},"capitalizationDegree":{"type":"number","format":"double","description":"Degree of capitalisation is the result of Equity / Total Liabilities"},"leverage":{"type":"number","format":"double","description":"Leverage is the result of Total Assets / Equity"},"bankDebtRatio":{"type":"number","format":"double","description":"Bank Debt Ratio is the result of Bank Debt / Shareholders' Equity"},"debtRatio":{"type":"number","format":"double","description":"Debt Ratio indicates the weight of third-party financing in relation to the company's total investments. Extremely high values (especially compared to the industry average) can signal structural anomalies in the company and an excessive financial burden. Debt Ratio is the result of Total Debt / Shareholders' Equity"}}},"leverageRatios":{"type":"object","properties":{"pfnEbitda":{"type":"number","format":"double","description":"PFN/ EBITDA is a financial ratio that indicates the sustainability of debt in relation to cash flows generated"},"ebitdaNetLeverage":{"type":"number","format":"double","description":"The net debt-to-EBITDA (earnings before interest depreciation and amortization) ratio is a measurement of leverage, calculated as a company's interest-bearing liabilities minus cash or cash equivalents, divided by its EBITDA"},"ffoNetLeverage":{"type":"number","format":"double","description":"FFO Net Leverage is the result of Net Financial Debt/ (Funds From Operations- Net Corresponding Interest)"},"ebitdaGrossLeverage":{"type":"number","format":"double","description":"The net debt-to-EBITDA (earnings before interest depreciation and amortization) ratio is a measurement of leverage, calculated as a company's interest-bearing liabilities minus cash or cash equivalents, divided by its EBITDA"}}},"liquidityRatios":{"type":"object","properties":{"cashShortTermFinancialDebt":{"type":"number","format":"double","description":"Short-term debt are the financial debt obligations that are due to be paid either within the next 12-month period or the current fiscal year. It is the result of liquid assets / Debt Short-term Gross Financial Debt"},"cashShortTermBankDebt":{"type":"number","format":"double","description":"Short-term debt are the bank debt obligations that are due to be paid either within the next 12-month period or the current fiscal year. It is the result of liquid assets / Payables to banks"},"cashTotalShortTermDebt":{"type":"number","format":"double","description":"Short-term debt are the debt obligations that are due to be paid either within the next 12-month period or the current fiscal year. It is the result of liquid assets / Short-term debts"},"fcfShortTermFinancialDebt":{"type":"number","format":"double","description":"Free Cash Flow Short Term Financial Debt measures the ratio of the company's liquidity to financial debt. It is the result of Free Cash Flow / Short-term Gross Financial Debt"}}},"profitability":{"type":"object","properties":{"ros":{"type":"number","format":"double","description":"Return on sales (ROS) is a ratio used to evaluate a company's operational efficiency (%)"},"roe":{"type":"number","format":"double","description":"Return on common equity (ROE) is a measure of financial performance calculated by dividing net income by shareholders' equity (%)"},"incidenceOfExtraFeaturesManagement":{"type":"number","format":"double","description":"Incidence Of Extra Features Management is the profit - loss for the year / MON* (%)"},"roi":{"type":"number","format":"double","description":"Return on Investment (ROI) is a popular profitability metric used to evaluate how well an investment has performed (%)"},"roaMonetary":{"type":"number","format":"double","description":"The term return on assets (ROA) refers to a financial ratio that indicates how profitable a company is in relation to its total assets. ROA Monetary is the result of Cash Flow / Total Assets (%)"}}},"structureRatios":{"type":"object","properties":{"netFinancialDebtEquityNetWorth":{"type":"number","format":"double","description":"Net Debt to Net Debt Plus Equity is a financial ratio that measures a company’s financial leverage by comparing its net debt to its total capitalization"},"pfnNetWorth":{"type":"number","format":"double","description":""},"financialDebtComposition":{"type":"number","format":"double","description":""},"netDebtTotalSources":{"type":"number","format":"double","description":""},"grossFinancialDebtNetWorth":{"type":"number","format":"double","description":""}}},"rae":{"type":"object","properties":{"code":{"type":"string","description":"rae code"},"description":{"type":"string","description":"The RAE code (Economic Activity Branch) is a three-digit numeric code used to classify companies based on the economic activity sector in which they operate"}}},"sae":{"type":"object","properties":{"code":{"type":"string","description":"sae code"},"description":{"type":"string","description":"The SAE code (Economic Activity Sector) is a numeric code used by Italian banks to classify companies based on their economic activity sector"}}},"Start":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"address":{"$ref":"#/components/schemas/Address"},"activityStatus":{"type":"string","description":"indicates the status of the company according to the Italian Chamber of Commerce","enum":["ATTIVA","REGISTRATA","INATTIVA","SOSPESA","IN_ISCRIZIONE","CESSATA"]},"creationTimestamp":{"type":"integer","description":"internal date of creation of the company"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"sdiCode":{"type":"string","description":"sdi code"},"sdiCodeTimestamp":{"type":"integer","description":"Latest update of sdi code"},"id":{"type":"string","description":"company id"},"registrationDate":{"type":"string","description":"date of registration of the company with the chamber of commerce"}}},"Name":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"address":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"town":{"type":"string","description":"Town where the company is located"}}}}},"creationTimestamp":{"type":"integer","description":"internal date of creation of the company"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"id":{"type":"string","description":"company id"}}},"Address":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"toponym":{"type":"string","description":"toponym of the address"},"street":{"type":"string","description":"street address"},"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"hamlet":{"type":"string","description":"District where the company is located"},"province":{"type":"string","description":"County (Province) where the company is located"},"zipCode":{"type":"string","description":"ZIP code (Italian CAP) where the company is located"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}},"townCode":{"type":"string","description":"common cadastral code (also known as national code or Belfiore code)"},"region":{"type":"object","properties":{"code":{"type":"string","description":"Code Area (Region) where the office is located"},"description":{"type":"string","description":"Complete name of the area (Region) where the office is located"}}}}}}},"Advanced":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"address":{"$ref":"#/components/schemas/Address"},"activityStatus":{"type":"string","description":"indicates the status of the company according to the Italian Chamber of Commerce","enum":["ATTIVA","REGISTRATA","INATTIVA","SOSPESA","IN_ISCRIZIONE","CESSATA"]},"reaCode":{"type":"string","description":"Economic and Administrative Repertory number for Chamber of Commerce"},"cciaa":{"type":"string","description":"Acronym of the city where the company was registered (e.g. RM as Rome, MI as Milan etc.)"},"atecoClassification":{"type":"object","properties":{"ateco":{"type":"object","properties":{"code":{"type":"string","description":"First level ATECO 2025 code"},"description":{"type":"string","description":"Description of the first level ATECO 2025 Code"}}},"ateco2022":{"type":"object","properties":{"code":{"type":"string","description":"First level ATECO 2022 code"},"description":{"type":"string","description":"Description of the first level ATECO 2022 Code"}}},"ateco2007":{"type":"object","properties":{"code":{"type":"string","description":"First level ATECO 2007 code"},"description":{"type":"string","description":"Description of the first level ATECO 2007 Code"}}}}},"detailedLegalForm":{"$ref":"#/components/schemas/LegalForms"},"startDate":{"type":"string","description":"start date of the company's activity"},"registrationDate":{"type":"string","description":"date of registration of the company with the chamber of commerce"},"endDate":{"type":"string","description":"end date of the company's activity"},"pec":{"type":"string","description":"company certified mail"},"taxCodeCeased":{"type":"boolean","description":"indicates whether the company has ceased or not according to the Tax Office"},"taxCodeCeasedTimestamp":{"type":"integer","description":"Latest update of ceased or not"},"vatGroup":{"$ref":"#/components/schemas/VatGroup"},"creationTimestamp":{"type":"integer","description":"internal date of creation of the company"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"sdiCode":{"type":"string","description":"sdi code"},"sdiCodeTimestamp":{"type":"integer","description":"Latest update of sdi code"},"balanceSheets":{"$ref":"#/components/schemas/BalanceSheets"},"shareHolders":{"$ref":"#/components/schemas/ShareHolders"},"id":{"type":"string","description":"company id"}}},"BalanceSheets":{"type":"object","properties":{"last":{"type":"object","properties":{"year":{"type":"integer","description":"Year of submission of the last balance sheet"},"balanceSheetDate":{"type":"string","description":"Date of submission of the last balance sheet"},"turnover":{"type":"integer","description":"annual revenue"},"netWorth":{"type":"integer","description":"annual profit"},"employees":{"type":"integer","description":"number of employees"},"shareCapital":{"type":"integer","description":"share capital of the company"},"totalStaffCost":{"type":"integer","description":"staff cost of the company"},"totalAssets":{"type":"integer","description":"total assets of the company"},"avgGrossSalary":{"type":"number","format":"float","description":"average gross salary of the company"}}},"all":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","description":"Year of submission of the last balance sheet"},"balanceSheetDate":{"type":"string","description":"Date of submission of the last balance sheet"},"turnover":{"type":"integer","description":"annual revenue"},"netWorth":{"type":"integer","description":"annual profit"},"employees":{"type":"integer","description":"number of employees"},"shareCapital":{"type":"integer","description":"share capital of the company"},"totalStaffCost":{"type":"integer","description":"staff cost of the company"},"totalAssets":{"type":"integer","description":"total assets of the company"},"avgGrossSalary":{"type":"number","format":"float","description":"average gross salary of the company"}}}}}},"ShareHolders":{"type":"array","items":{"type":"object","properties":{"companyName":{"type":"string","description":"Legal name of the shareholder"},"name":{"type":"string","description":"First Name of the shareholder"},"surname":{"type":"string","description":"Surname of the shareholder"},"taxCode":{"type":"string","description":"Tax code of shareholder"},"percentShare":{"type":"number","format":"double","description":"Percentage ownership of the company (%)"}}}},"DataEnrichmentAddress":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"address":{"$ref":"#/components/schemas/Address"},"creationTimestamp":{"type":"integer","description":"internal date of creation of the company"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"id":{"type":"string","description":"company id"}}},"DataEnrichmentPec":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"id":{"type":"string","description":"company id"},"pec":{"type":"string","description":"company certified mail"},"history":{"type":"array","items":{"type":"object","properties":{"pec":{"type":"string","description":"company certified mail"},"timestamp":{"type":"integer","description":"timestamp until which it was active"}}}}}},"DataEnrichmentShareholders":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"id":{"type":"string","description":"company id"},"shareHolders":{"$ref":"#/components/schemas/ShareHolders"}}},"VatGroup":{"type":"object","properties":{"vatGroupParticipation":{"type":"boolean","description":"participation of the company in the VAT group"},"isVatGroupLeader":{"type":"boolean","description":"if the company is at the head of the VAT group"},"registryOk":{"type":"boolean","description":"if the company data is correct"}}},"VatGroupTaxCode":{"type":"object","properties":{"vatGroupParticipation":{"type":"boolean","description":"participation of the company in the VAT group"},"isVatGroupLeader":{"type":"boolean","description":"if the company is at the head of the VAT group"},"registryOk":{"type":"boolean","description":"if the company data is correct"},"taxCodeVatCodeConsistent":{"type":"boolean","description":"consistency between the tax code and VAT number entered"},"taxCodePresent":{"type":"boolean","description":"whether or not the Tax Code belongs to the VAT Group"},"taxCodeEntrant":{"type":"boolean","description":"presence or absence of the Tax Code to the VAT Group"},"vatGroupMembers":{"type":"array","description":"array of tax codes present in the VAT group","items":{"type":"string"}}}},"LegalForms":{"type":"object","properties":{"code":{"type":"string","description":"company legal code"},"description":{"type":"string","description":"description of the legal code"}}},"EuStart":{"type":"object","properties":{"valid":{"type":"boolean","description":"if the VAT number is valid"},"formatValid":{"type":"boolean","description":"if the VAT number is formally valid"},"countryCode":{"type":"string","description":"company country code"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"companyName":{"type":"string","description":"Legal name of the company"},"companyAddress":{"type":"string","description":"company address"}}},"Split":{"type":"object","properties":{"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"companyName":{"type":"string","description":"Legal name of the company"},"companyType":{"type":"string","description":"company category"},"startingDateTimestamp":{"type":"integer","description":"effective timestamp for being subject to split payment"},"lastUpdateTimestamp":{"type":"integer","description":"timestamp of the update"}}},"Pa":{"type":"object","properties":{"paId":{"type":"integer","description":"institution id"},"companyName":{"type":"string","description":"Legal name of the company"},"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"vatCode":{"type":"string","description":"VAT registration number (Italian Partita IVA)"},"establishmentDate":{"type":"string","description":"date of establishment"},"terminationDate":{"type":"string","description":"date of termination"},"atecoClassification":{"type":"object","properties":{"ateco":{"type":"object","properties":{"code":{"type":"string","description":"First level ATECO code"},"description":{"type":"string","description":"Description of the first level ATECO Code"}}}}},"detailedLegalForm":{"type":"object","properties":{"code":{"type":"string","description":"company legal code"},"description":{"type":"string","description":"description of the legal code"}}},"phone":{"type":"string","description":"Company telephone number"},"fax":{"type":"string","description":"Company fax number"},"url":{"type":"string","description":"Website URL"},"managerName":{"type":"string","description":"First name of the manager"},"managerSurname":{"type":"string","description":"Surname of the manager"},"managerTitle":{"type":"string","description":"Title of the manager"},"address":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"town":{"type":"object","properties":{"code":{"type":"string","description":"common cadastral code (also known as national code or Belfiore code)"},"number":{"type":"string","description":"town number"},"description":{"type":"string","description":"town name where the company is located"},"istat":{"type":"string","description":"ISTAT code"}}},"province":{"type":"object","properties":{"code":{"type":"string","description":"province code"},"number":{"type":"string","description":"province number"},"description":{"type":"string","description":"province name where the company is located"}}},"toponym":{"type":"string","description":"toponym of the address"},"street":{"type":"string","description":"street address"},"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"hamlet":{"type":"string","description":"District where the company is located"},"zipCode":{"type":"string","description":"ZIP code (Italian CAP) where the company is located"},"region":{"type":"object","properties":{"code":{"type":"string","description":"region code"},"description":{"type":"string","description":"region name where the company is located"}}},"area":{"type":"object","properties":{"code":{"type":"string","description":"area code"},"description":{"type":"string","description":"area name where the company is located"}}}}}}},"participationStatus":{"type":"string","description":"participation status"},"siopeEntityCode":{"type":"string","description":"SIOPE entity code"},"siopeTypeId":{"type":"string","description":"SIOPE type id"},"siopeTypeCode":{"type":"string","description":"SIOPE type code"},"siopeTypeDescription":{"type":"string","description":"SIOPE type description"},"siopeInclusionDate":{"type":"string","description":"SIOPE inclusion date"},"siopeExclusionDate":{"type":"string","description":"SIOPE exclusion date"},"ipaEntityCode":{"type":"string","description":"IPA entity code"},"ipaCategoryId":{"type":"string","description":"IPA category id"},"ipaCategoryCode":{"type":"string","description":"IPA category code"},"ipaCategoryDescription":{"type":"string","description":"IPA category description"},"ipaTypeCode":{"type":"string","description":"IPA type code"},"ipaTypeDescription":{"type":"string","description":"IPA type descritpion"},"ipaInclusionDate":{"type":"string","description":"IPA inclusion date"},"ipaExclusionDate":{"type":"string","description":"IPA exclusion date"},"miurEntityCode":{"type":"string","description":"MIUR entity code"},"miurTypeId":{"type":"string","description":"MIUR type id"},"miurTypeCode":{"type":"string","description":"MIUR type code"},"miurTypeDescription":{"type":"string","description":"MIUR type description"},"dtTypeId":{"type":"string","description":"DT type id"},"dtTypeCode":{"type":"string","description":"DT type code"},"dtTypeDescription":{"type":"string","description":"DT type description"},"ssnEntityCode":{"type":"string","description":"SSN entity code"},"s13IstatEntityCode":{"type":"string","description":"ISTAT S13 entity code"},"s13IstatTypeId":{"type":"string","description":"ISTAT S13 type id"},"s13IstatTypeCode":{"type":"string","description":"ISTAT S13 type code"},"s13IstatTypeDescription":{"type":"string","description":"ISTAT S13 type description"},"s13IstatInclusionDate":{"type":"string","description":"ISTAT S13 inclusion date"},"s13IstatExclusionDate":{"type":"string","description":"ISTAT S13 exclusion date"},"dlgs1182011TypeId":{"type":"string","description":"DLGS 118 2011 type id"},"dlgs1182011TypeCode":{"type":"string","description":"DLGS 118 2011 type code"},"dlgs1182011TypeDescription":{"type":"string","description":"DLGS 118 2011type description"},"dlgs1182011InclusionDate":{"type":"string","description":"DLGS 118 2011 inclusion date"},"dlgs1182011ExclusionDate":{"type":"string","description":"DLGS 118 2011 exclusion date"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"pa":{"type":"boolean","description":"is it public administration or not"},"paInvoicingOffice":{"type":"array","items":{"$ref":"#/components/schemas/Office"}}}},"Office":{"type":"object","properties":{"administrationCode":{"type":"string","description":"administration code"},"ouCode":{"type":"string","description":"ou code"},"sdiCode":{"type":"string","description":"sdi code"},"ouDescription":{"type":"string","description":"ou description"},"region":{"type":"string","description":"region name where the office is located"},"province":{"type":"string","description":"province code where the office is located"},"town":{"type":"string","description":"town name where the office is located"},"streetName":{"type":"string","description":"complete name of the street where the office is located"},"zipCode":{"type":"string","description":"ZIP code (Italian CAP) where the office is located"},"taxCode":{"type":"string","description":"Tax code (Italian Codice Fiscale)"},"taxCodeVerificationDate":{"type":"string","description":"Tax code verification date"},"sfeStartDate":{"type":"string","description":"Sfe start date"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of office data"}}},"PostBody":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"}}},"Callback":{"type":"object","properties":{"method":{"type":"string","description":"Indicate through which method you want to receive data with the callback, by default it is POST","enum":["POST","JSON"]},"field":{"type":"string","description":"Name of the field containing the callback return data (required with method: POST)"},"url":{"type":"string","description":"Url where the callback call will be made","example":"https://www.mysite.it/callback.php"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"contains key:value strings that you want to arrive as headers","example":{"session_id":"9834r5fh589494"}},"data":{"type":"object","description":"Object to be completed at your convenience with additional data that you can use back with the callback"}}},"Request":{"type":"object","properties":{"state":{"type":"string","description":"request state","enum":["PENDING","DONE"]},"id":{"type":"string","description":"request id"}}},"FrStart":{"type":"object","properties":{"siretCode":{"type":"string","description":"Local Unique Identifier (Companies House ID; KvK; Chamber Of Commerce; etc.)"},"companyName":{"type":"string","description":"Legal name of the company"},"tradingName":{"type":"string","description":"The name a company trades under, if different to its registered name"},"aliasName":{"type":"string","description":"An alternative name a company may be known as"},"sirenCode":{"type":"string","description":"Local Unique Identifier (Companies House ID; KvK; Chamber of Commerce; etc); differs from siretCode by not including Branch ID where applicable"},"coCode":{"type":"string","description":"Alternative Company Registration Number"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","CEASED"]},"registrationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"vatCode":{"type":"string","description":"VAT registration number"},"address":{"$ref":"#/components/schemas/FrAddress"},"creationTimestamp":{"type":"integer","description":"internal date of creation of the company"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"id":{"type":"string","description":"company id"}}},"FrAdvanced":{"type":"object","properties":{"siretCode":{"type":"string","description":"Local Unique Identifier (Companies House ID; KvK; Chamber Of Commerce; etc.)"},"companyName":{"type":"string","description":"Legal name of the company"},"tradingName":{"type":"string","description":"The name a company trades under, if different to its registered name"},"aliasName":{"type":"string","description":"An alternative name a company may be known as"},"sirenCode":{"type":"string","description":"Local Unique Identifier (Companies House ID; KvK; Chamber of Commerce; etc); differs from siretCode by not including Branch ID where applicable"},"coCode":{"type":"string","description":"Alternative Company Registration Number"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","CEASED"]},"creditWorthy":{"type":"integer","description":"Indicator if the Company is Creditworthy, 0 - No, 1 – Yes","enum":[0,1]},"registrationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"vatCode":{"type":"string","description":"VAT registration number"},"address":{"$ref":"#/components/schemas/FrAddress"},"internationalClassification":{"type":"object","properties":{"naf":{"type":"object","properties":{"code":{"type":"string","description":"Naf code"},"description":{"type":"string","description":"Description of the Naf Code"}}},"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}}}},"detailedLegalForm":{"type":"object","properties":{"code":{"type":"string","description":"company legal code"},"description":{"type":"string","description":"description of the legal code"}}},"balanceSheets":{"$ref":"#/components/schemas/FrBalanceSheets"},"creationTimestamp":{"type":"integer","description":"internal date of creation of the company"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"allOffice":{"type":"array","items":{"type":"object","properties":{"siretCode":{"type":"string","description":"Local Unique Identifier (Companies House ID; KvK; Chamber Of Commerce; etc.)"},"companyName":{"type":"string","description":"Legal name of the company"},"address":{"$ref":"#/components/schemas/FrAddress"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","CEASED"]}}}},"id":{"type":"string","description":"company id"}}},"FrAddress":{"oneOf":[{"$ref":"#/components/schemas/Registered"},{"$ref":"#/components/schemas/Branch"}]},"Registered":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"street":{"type":"string","description":"street address according to the National Address public database"},"streetNumber":{"type":"string","description":"number of the address according to the National Address public database"},"streetName":{"type":"string","description":"complete name of the street where the company is located according to the Chamber of Commerce"},"streetName2":{"type":"string","description":"Line 2 of the companies registered address according to the Chamber of Commerce. Usually optional"},"streetName3":{"type":"string","description":"Line 3 of the companies registered address according to the Chamber of Commerce. Usually optional"},"streetName4":{"type":"string","description":"Line 4 of the companies registered address according to the Chamber of Commerce; this is typically region, province, county or state"},"town":{"type":"string","description":"Town where the company is located according to the Chamber of Commerce"},"zipCode":{"type":"string","description":"ZIP code where the company is located according to the Chamber of Commerce"},"country":{"type":"string","description":"The country of the registered company according to the Chamber of Commerce"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates according to the National Address public database (longitude, latitude)","items":{"type":"number","format":"double"}}}},"townCode":{"type":"string","description":"INSEE code of the municipality according to the National Address public database"},"department":{"type":"object","properties":{"code":{"type":"string","description":"department INSEE code according to the National Address public database"},"description":{"type":"string","description":"department INSEE description according to the National Address public database"}}},"region":{"type":"object","properties":{"code":{"type":"string","description":"region INSEE code according to the National Address public database"},"description":{"type":"string","description":"region INSEE description according to the National Address public database"}}}}}}},"Branch":{"type":"object","properties":{"branchOffice":{"type":"object","properties":{"street":{"type":"string","description":"street address according to the National Address public database"},"streetNumber":{"type":"string","description":"number of the address according to the National Address public database"},"streetName":{"type":"string","description":"complete name of the street where the company is located according to the Chamber of Commerce"},"streetName2":{"type":"string","description":"Line 2 of the companies registered address according to the Chamber of Commerce. Usually optional"},"streetName3":{"type":"string","description":"Line 3 of the companies registered address according to the Chamber of Commerce. Usually optional"},"streetName4":{"type":"string","description":"Line 4 of the companies registered address according to the Chamber of Commerce; this is typically region, province, county or state"},"town":{"type":"string","description":"Town where the company is located according to the Chamber of Commerce"},"zipCode":{"type":"string","description":"ZIP code where the company is located according to the Chamber of Commerce"},"country":{"type":"string","description":"The country of the registered company according to the Chamber of Commerce"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates according to the National Address public database (longitude, latitude)","items":{"type":"number","format":"double"}}}},"townCode":{"type":"string","description":"INSEE code of the municipality according to the National Address public database"},"department":{"type":"object","properties":{"code":{"type":"string","description":"department INSEE code according to the National Address public database"},"description":{"type":"string","description":"department INSEE description according to the National Address public database"}}},"region":{"type":"object","properties":{"code":{"type":"string","description":"region INSEE code according to the National Address public database"},"description":{"type":"string","description":"region INSEE description according to the National Address public database"}}}}}}},"FrBalanceSheets":{"type":"object","properties":{"last":{"type":"object","properties":{"year":{"type":"integer","description":"Year of submission of the last balance sheet"},"balanceSheetDate":{"type":"string","description":"Date of submission of the last balance sheet"},"turnover":{"type":"number","format":"float","description":"annual revenue"},"netWorth":{"type":"number","format":"float","description":"annual profit"},"employees":{"type":"integer","description":"number of employees"},"ebitda":{"type":"number","format":"float","description":"ebitda of the company"}}},"all":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","description":"Year of submission of the last balance sheet"},"balanceSheetDate":{"type":"string","description":"Date of submission of the last balance sheet"},"turnover":{"type":"number","format":"float","description":"annual revenue"},"netWorth":{"type":"number","format":"float","description":"annual profit"},"employees":{"type":"integer","description":"number of employees"},"ebitda":{"type":"number","format":"float","description":"ebitda of the company"}}}}}},"DeStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"company number from the German commercial register"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/DeAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"DeAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"DeAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"company number from the German commercial register"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/DeAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"WwBalanceSheets":{"type":"object","properties":{"last":{"type":"object","properties":{"year":{"type":"integer","description":"Year of submission of the last balance sheet"},"balanceSheetDate":{"type":"string","description":"Date of submission of the last balance sheet"},"employees":{"type":"integer","description":"number of employees"},"netWorth":{"type":"number","format":"float","description":"annual profit"},"operatingRevenue":{"type":"number","format":"float","description":"Total value of production"},"equity":{"type":"number","format":"float","description":"residual value of a company's assets after all liabilities have been subtracted"},"totalAssets":{"type":"number","format":"float","description":"Total assets"}}},"all":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","description":"Year of submission of the last balance sheet"},"balanceSheetDate":{"type":"string","description":"Date of submission of the last balance sheet"},"employees":{"type":"integer","description":"number of employees"},"netWorth":{"type":"number","format":"float","description":"annual profit"},"operatingRevenue":{"type":"number","format":"float","description":"Total value of production"},"equity":{"type":"number","format":"float","description":"residual value of a company's assets after all liabilities have been subtracted"},"totalAssets":{"type":"number","format":"float","description":"Total assets"}}}}}},"EsStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"taxCode":{"type":"string","description":"tax identification number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/EsAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"EsAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"EsAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"taxCode":{"type":"string","description":"tax identification number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/EsAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"PtStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"taxCode":{"type":"string","description":"tax identification number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/PtAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"PtAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"PtAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"taxCode":{"type":"string","description":"tax identification number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/PtAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"GbStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"The Company Registration Number (CRN) is a unique number assigned to each company upon its incorporation at Companies House, the government agency responsible for registering businesses in the United Kingdom"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/GbAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"GbAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"GbAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"The Company Registration Number (CRN) is a unique number assigned to each company upon its incorporation at Companies House, the government agency responsible for registering businesses in the United Kingdom"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/GbAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"WwStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"taxCode":{"type":"string","description":"tax identification number"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"company registration number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/WwAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"WwAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"WwAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"taxCode":{"type":"string","description":"tax identification number"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"company registration number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/WwAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"WwTop":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"companyName":{"type":"string","description":"Legal name of the company"},"nativeCompanyName":{"type":"string","description":"Legal name of the company in local language"},"companySize":{"type":"string","description":"size of the company","enum":["Very large companies","Large companies","Medium sized companies","Small companies"]},"taxCode":{"type":"string","description":"tax identification number"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"companyNumber":{"type":"string","description":"company registration number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"markers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"The local nomenclature of the tax identifier, if it corresponds to multiple labels, will be combined into a single string separated by ,"},"number":{"type":"string","description":"The company identification number for the category indicated in markers.types"},"types":{"type":"array","items":{"type":"string","description":"The normalized category of the identification number","enum":["Trade register number","TIN","VAT/Tax number","Statistical number","European VAT number","Company ID number","Trade register number, VAT/Tax number"]}}}}},"address":{"$ref":"#/components/schemas/WwAddressTop"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Nace primary code"},"description":{"type":"string","description":"Description of the Nace Code"},"core":{"type":"string","description":"The macro category of the NACE code"},"section":{"type":"string","description":"The main section of the NACE code"},"division":{"type":"string","description":"The division of the NACE code"},"group":{"type":"string","description":"The group of the NACE code"}}}},"secondary":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Nace secondary code"},"description":{"type":"string","description":"Description of the Nace Code"},"core":{"type":"string","description":"The macro category of the NACE code"},"section":{"type":"string","description":"The main section of the NACE code"},"division":{"type":"string","description":"The division of the NACE code"},"group":{"type":"string","description":"The group of the NACE code"}}}}}},"naics":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Naics primary code"},"description":{"type":"string","description":"Description of the Naics Code"},"section":{"type":"string","description":"The main section of the Naics code"},"division":{"type":"string","description":"The division of the Naics code"},"group":{"type":"string","description":"The group of the Naics code"}}}},"secondary":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Naics secondary code"},"description":{"type":"string","description":"Description of the Naics Code"},"section":{"type":"string","description":"The main section of the Naics code"},"division":{"type":"string","description":"The division of the Naics code"},"group":{"type":"string","description":"The group of the Naics code"}}}}}},"sic":{"type":"object","properties":{"primary":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Sic primary code"},"description":{"type":"string","description":"Description of the Sic Code"},"section":{"type":"string","description":"The main section of the Sic code"},"division":{"type":"string","description":"The division of the Sic code"},"group":{"type":"string","description":"The group of the Sic code"}}}},"secondary":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Sic secondary code"},"description":{"type":"string","description":"Description of the Sic Code"},"section":{"type":"string","description":"The main section of the Sic code"},"division":{"type":"string","description":"The division of the Sic code"},"group":{"type":"string","description":"The group of the Sic code"}}}}}}}},"nationalClassification":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","description":"The type of industrial code used in the company's country (e.g. in Italy it is ATECO). In the case of multiple elements in the array there is a 1:1 correspondence with the index of the primary array"}},"primary":{"type":"array","items":{"type":"string","description":"The company's primary industrial code in its local classification (e.g. ATECO in Italy). In the case of multiple elements in the array there is a 1:1 correspondence with the array index national type"}},"secondary":{"type":"array","items":{"type":"string","description":"The company's secondary industrial code in its local classification"}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"WwAddressTop":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"town":{"type":"string","description":"Town where the company is located"},"nativeTown":{"type":"string","description":"Town where the company is located in local language"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}},"county":{"type":"string","description":"Macro area where the company is located"},"nuts1":{"type":"string","description":"The nomenclature of statistical territorial units. Identifies the distribution of the territory of the European Union for statistical purposes."},"nuts2":{"type":"string","description":"The nomenclature of statistical territorial units. Identifies the distribution of the territory of the European Union for statistical purposes."},"nuts3":{"type":"string","description":"The nomenclature of statistical territorial units. Identifies the distribution of the territory of the European Union for statistical purposes."},"usMetropolitanArea":{"type":"string","description":"The metropolitan area (USA only) where the company is located"},"usState":{"type":"string","description":"The US state of the company's headquarters (the same information is found in the locationArea field)"},"locationArea":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"type of region"},"description":{"type":"string","description":"The region of the company's headquarters"}}}}}}}},"BeStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"companyNumber":{"type":"string","description":"company number from the Belgian commercial register"},"establishmentNumber":{"type":"string","description":"establishment unit number assigned to a specific branch or location in the Belgian commercial register"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"taxCode":{"type":"string","description":"tax identification number"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/BeAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"BeAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"BeAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"companyNumber":{"type":"string","description":"company number from the Belgian commercial register"},"establishmentNumber":{"type":"string","description":"establishment unit number assigned to a specific branch or location in the Belgian commercial register"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"taxCode":{"type":"string","description":"tax identification number"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/BeAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"AtStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"companyNumber":{"type":"string","description":"company number from the Austrian commercial register"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/AtAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"AtAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"AtAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"companyNumber":{"type":"string","description":"company number from the Austrian commercial register"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/AtAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"ChStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"companyNumber":{"type":"string","description":"Swiss cantonal Commercial Register number"},"vatCode":{"type":"string","description":"Swiss VAT identification number"},"taxCode":{"type":"string","description":"Swiss tax identifier"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/ChAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"ChAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"ChAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"companyNumber":{"type":"string","description":"Swiss cantonal Commercial Register number"},"vatCode":{"type":"string","description":"Swiss VAT identification number"},"taxCode":{"type":"string","description":"Swiss tax identifier"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/ChAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"PlStart":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"companyNumber":{"type":"string","description":"company number from the Poland commercial register"},"regonNumber":{"type":"string","description":"Polish national economy register number (Only the 9-digit main entity REGON is accepted.)."},"taxCode":{"type":"string","description":"tax identification number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/PlAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"}}},"PlAddress":{"type":"object","properties":{"registeredOffice":{"type":"object","properties":{"streetNumber":{"type":"string","description":"number of the address"},"streetName":{"type":"string","description":"complete name of the street where the company is located"},"town":{"type":"string","description":"Town where the company is located"},"zipCode":{"type":"string","description":"ZIP code where the company is located"},"country":{"type":"string","description":"The ISO2 code of the country of the company's headquarters"},"gps":{"type":"object","properties":{"coordinates":{"type":"array","description":"company location coordinates (longitude, latitude)","items":{"type":"number","format":"double"}}}}}}}},"PlAdvanced":{"type":"object","properties":{"id":{"type":"string","description":"company id"},"companyName":{"type":"string","description":"Legal name of the company"},"companyNumber":{"type":"string","description":"company number from the Poland commercial register"},"regonNumber":{"type":"string","description":"Polish national economy register number (Only the 9-digit main entity REGON is accepted.)."},"taxCode":{"type":"string","description":"tax identification number"},"leiCode":{"type":"string","description":"Legal Entity Identifier. It is a unique 20-character alphanumeric code, assigned to each legal entity (companies, funds, non-profit organizations, etc.) that operates in the financial markets globally"},"vatCode":{"type":"string","description":"VAT registration number in European format"},"activityStatus":{"type":"string","description":"company status","enum":["ACTIVE","DISSOLVED","INACTIVE (NO PRECISION)","ACTIVE (DORMANT)","STATUS UNKNOWN","IN LIQUIDATION","DISSOLVED (LIQUIDATION)","ADMINISTRATIVELY SUSPENDED","DISSOLVED (MERGER OR TAKE-OVER)","DISSOLVED (BANKRUPTCY)","ACTIVE (ADMINISTRATIVELY NON-COMPLIANT)","BANKRUPTCY","ACTIVE (INSOLVENCY PROCEEDINGS)","ACTIVE (DEFAULT OF PAYMENT)","ACTIVE (REORGANIZATION)","DISSOLVED (DEMERGER)","ACTIVE (RESCUE PLAN)"]},"incorporationDate":{"type":"string","description":"Date of the Incorporation of the Company"},"address":{"$ref":"#/components/schemas/PlAddress"},"lastUpdateTimestamp":{"type":"integer","description":"Latest update of company data"},"contacts":{"type":"object","properties":{"fax":{"type":"string","description":"The company fax number registered in the chamber of commerce"},"phone":{"type":"string","description":"The company telephone number registered in the chambers of commerce"},"website":{"type":"string","description":"The company's main website"}}},"internationalClassification":{"type":"object","properties":{"nace":{"type":"object","properties":{"code":{"type":"string","description":"Nace code"},"description":{"type":"string","description":"Description of the Nace Code"}}},"naics":{"type":"object","properties":{"code":{"type":"string","description":"Naics code"},"description":{"type":"string","description":"Description of the Naics Code"}}},"sic":{"type":"object","properties":{"code":{"type":"string","description":"Sic code"},"description":{"type":"string","description":"Description of the Sic Code"}}}}},"balanceSheets":{"$ref":"#/components/schemas/WwBalanceSheets"}}},"Ubo":{"type":"object","properties":{"name":{"type":"string","description":"ultimate beneficial owner name"},"surname":{"type":"string","description":"ultimate beneficial owner surname"},"taxCode":{"type":"string","description":"ultimate beneficial owner tax code"},"birthDate":{"type":"string","description":"ultimate beneficial owner birth date"},"birthTown":{"type":"string","description":"ultimate beneficial owner birth town"},"birthProvince":{"type":"object","properties":{"code":{"type":"string","description":"birth province code"},"description":{"type":"string","description":"birth province name"}}},"address":{"type":"object","properties":{"toponym":{"type":"string","description":"toponym of the address where the ultimate beneficial owner is located"},"street":{"type":"string","description":"street address where the ultimate beneficial owner is located"},"streetNumber":{"type":"string","description":"number of the address where the ultimate beneficial owner is located"},"town":{"type":"string","description":"Town where the ultimate beneficial owner is located"},"province":{"type":"object","properties":{"code":{"type":"string","description":"province code where the ultimate beneficial owner is located"},"description":{"type":"string","description":"province name where the ultimate beneficial owner is located"}}},"zipCode":{"type":"string","description":"ZIP code (Italian CAP) where the ultimate beneficial owner is located"},"region":{"type":"object","properties":{"code":{"type":"string","description":"Code of the area (Region) where the ultimate beneficial owner is located"},"description":{"type":"string","description":"Complete name of the area (Region) where the ultimate beneficial owner is located"}}}}},"roles":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"role code"},"description":{"type":"string","description":"role description"},"type":{"type":"string","description":"role type"}}}}}},"Pec":{"type":"object","properties":{"pec":{"type":"string","description":"company certified mail"},"history":{"type":"array","items":{"type":"object","properties":{"pec":{"type":"string","description":"company certified mail"},"timestamp":{"type":"integer","description":"timestamp until which it was active"}}}}}},"Sdi":{"type":"object","properties":{"sdiCode":{"type":"string","description":"sdi code"},"id":{"type":"string","description":"company id"}}},"Closed":{"type":"object","properties":{"taxCodeCeased":{"type":"boolean","description":"indicates whether the company has ceased or not according to the Tax Office"},"id":{"type":"string","description":"company id"}}},"MonitorRequest":{"type":"object","properties":{"code":{"type":"string","description":"identification code to identify the company"},"dataset":{"type":"string","description":"reference endpoint dataset"},"monitoredFields":{"type":"array","description":"array of fields you want to monitor","items":{"type":"string"}},"callback":{"$ref":"#/components/schemas/Callback"},"owner":{"type":"string","description":"request owner"},"createdOn":{"type":"string","description":"creation date of the request","format":"date"},"companyId":{"type":"string","description":"ID of the company you want to monitor"},"vatCode":{"type":"string","description":"vat code of the company you want to monitor"},"taxCode":{"type":"string","description":"tax code of the company you want to monitor"},"companyName":{"type":"string","description":"name of the company you want to monitor"},"updatedFields":{"type":"object","description":"object with all the fields to monitor","properties":{"fieldX":{"type":"string"},"fieldY":{"type":"string"}}},"latestDataset":{"description":"object with the latest company dataset","oneOf":[{"$ref":"#/components/schemas/Aml"},{"$ref":"#/components/schemas/Marketing"},{"$ref":"#/components/schemas/Stakeholders"},{"$ref":"#/components/schemas/Full"},{"$ref":"#/components/schemas/Start"},{"$ref":"#/components/schemas/Advanced"},{"$ref":"#/components/schemas/ShareHolders"},{"$ref":"#/components/schemas/Address"},{"$ref":"#/components/schemas/Pec"},{"$ref":"#/components/schemas/Sdi"},{"$ref":"#/components/schemas/Closed"},{"$ref":"#/components/schemas/Name"},{"$ref":"#/components/schemas/VatGroup"},{"$ref":"#/components/schemas/Ubo"},{"$ref":"#/components/schemas/FrStart"},{"$ref":"#/components/schemas/FrAdvanced"}]},"previousDataset":{"description":"object with the penultimate company dataset","oneOf":[{"$ref":"#/components/schemas/Aml"},{"$ref":"#/components/schemas/Marketing"},{"$ref":"#/components/schemas/Stakeholders"},{"$ref":"#/components/schemas/Full"},{"$ref":"#/components/schemas/Start"},{"$ref":"#/components/schemas/Advanced"},{"$ref":"#/components/schemas/ShareHolders"},{"$ref":"#/components/schemas/Address"},{"$ref":"#/components/schemas/Pec"},{"$ref":"#/components/schemas/Sdi"},{"$ref":"#/components/schemas/Closed"},{"$ref":"#/components/schemas/Name"},{"$ref":"#/components/schemas/VatGroup"},{"$ref":"#/components/schemas/Ubo"},{"$ref":"#/components/schemas/FrStart"},{"$ref":"#/components/schemas/FrAdvanced"}]},"checkedOn":{"type":"string","description":"date of last inspection","format":"date"},"nextOn":{"type":"string","description":"date of next check-up","format":"date"},"expiresOn":{"type":"string","description":"monitoring expiration date","format":"date"},"autorenew":{"type":"boolean","description":"indicates whether auto-renewal is set"},"id":{"type":"string","description":"request id"}}},"MonitorPayload":{"type":"object","properties":{"code":{"type":"string","description":"identification code to identify the company; it could be a tax code, a VAT number or a company ID","example":"60d1bfc731177b0a092cdfc1"},"dataset":{"type":"string","description":"reference endpoint dataset","example":"IT-advanced","enum":["IT-aml","IT-marketing","IT-stakeholders","IT-full","IT-start","IT-advanced","IT-shareholders","IT-address","IT-pec","IT-closed","IT-vatgroup","IT-sdicode","IT-name","IT-ubo","FR-start","FR-advanced"]},"monitoredFields":{"type":"array","description":"array of fields you want to monitor (to access nested fields, you need to use a dot delimiter, also called dot notation); you can omit it to monitor the entire dataset","example":["activityStatus","balanceSheets.last"],"items":{"type":"string"}},"callback":{"$ref":"#/components/schemas/Callback"},"autorenew":{"type":"boolean","description":"if you want to set auto-renewal, the default is true","default":true},"cciaa":{"type":"string","description":"ff there are multiple companies with the same VAT number, you can indicate the relevant Chamber of Commerce to identify it (valid for Italy only)","example":"RM"}},"required":["code","dataset"]},"MonitorRequests":{"type":"object","properties":{"companyName":{"type":"string","description":"name of the company you want to monitor"},"checkedOn":{"type":"string","description":"date of last inspection","format":"date"},"nextOn":{"type":"string","description":"date of next check-up","format":"date"},"expiresOn":{"type":"string","description":"monitoring expiration date","format":"date"},"id":{"type":"string","description":"request id"}}}}},"paths":{"/IT-aml/{vatCode_or_taxCode}":{"get":{"tags":["IT"],"summary":"Anti Money Laundering","description":"Call that allows you to extract data from a company for anti-money laundering purposes. \n\nDuring periods of high traffic, official data sources may experience slower response times. To ensure service availability during these peak load periods or maintenance, we've implemented a 30-second timeout. Upon timeout, a unique ID is generated, allowing clients to poll for status updates. In this case an http code 302 and a Location header with address https://company.openapi.com/IT-check_id/ID are returned. The call may be automatically redirected by your system so make sure you have used a valid token for both endpoints or disable automatic redirection. \n\nHowever, we strongly recommend using the POST method to set up a callback URL. This eliminates the need for polling as our system will proactively notify you via the callback when the request is complete.","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Aml"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"synchronous":{"value":{"data":{"publicTenders":[{"year":"2021","applied":41,"won":42,"value":13812.52},{"year":"2020","applied":48,"won":51,"value":10274.94}],"managers":[{"name":"LUCA","surname":"SCURIATTI","roles":[{"role":{"code":"AUN","description":"Managing director"},"roleStartDate":"2020-09-10T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"SCRLCU73R02H501H","birthDate":"1973-10-02T00:00:00","age":49,"birthTown":"ROMA (RM)","isLegalRepresentative":true},{"companyName":"OPEN HOLDING SRL","roles":[{"role":{"code":"SOU","description":"Sole owner"},"roleStartDate":"2022-12-05T00:00:00"}],"taxCode":"16935371001","isLegalRepresentative":false},{"name":"SIMONE","surname":"DESANTIS","roles":[{"role":{"code":"PP","description":"Special representative/agent"},"roleStartDate":"2013-10-17T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"DSNSMN80M11L117F","birthDate":"1980-08-11T00:00:00","age":42,"birthTown":"TERNI (TR)","isLegalRepresentative":false},{"name":"SHAUN","surname":"DE LUCIA","roles":[{"role":{"code":"PP","description":"Special representative/agent"},"roleStartDate":"2013-10-17T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"DLCSHN77S29Z114J","birthDate":"1977-11-29T00:00:00","age":45,"birthTown":"STOKE ON TRENT (E)","isLegalRepresentative":false}],"shareholders":[{"shareholdersInformation":[{"taxCode":"16935371001","openapiNumber":"IT8A380807S0001","companyName":"OPEN HOLDING SRL","sinceDate":"2022-11-23T00:00:00","streetName":"VIALE FILIPPO TOMMASO MARINETTI 221","zipCode":"00143","town":"ROMA"}],"percentShare":100}],"debts":[{"code":"IIC099","value":0},{"code":"IIC098","value":5426},{"code":"IIC091","value":0},{"code":"IIC090","value":0},{"code":"IIC092","value":0},{"code":"IIC093","value":0},{"code":"IIC103","value":0},{"code":"IIC102","value":0},{"code":"IIC117","value":52106},{"code":"IIC097","value":38777},{"code":"IIC107","value":0},{"code":"IIC112","value":19752},{"code":"IIC113","value":0},{"code":"IIC109","value":0},{"code":"IIC105","value":0},{"code":"IIC220","value":0},{"code":"IIC221","value":0},{"code":"IIC106","value":0},{"code":"IIC094","value":2884},{"code":"IIC095","value":0},{"code":"IIC096","value":0},{"code":"IIC108","value":0},{"code":"IIC185","value":0},{"code":"IIC184","value":0},{"code":"IIC104","value":0},{"code":"IIC101","value":0},{"code":"IIC100","value":554848},{"code":"IIC114","value":26268},{"code":"IIC115","value":0},{"code":"IIC116","value":781131},{"code":"IIC110","value":171953},{"code":"IIC111","value":13329},{"code":"IIC334","value":5426},{"code":"IIC329","value":0},{"code":"IIC333","value":38777},{"code":"IIC338","value":0},{"code":"IIC337","value":0},{"code":"IIC330","value":0},{"code":"IIC336","value":0},{"code":"IIC342","value":19752},{"code":"IIC340","value":0},{"code":"IIC339","value":0},{"code":"IIC331","value":0},{"code":"IIC332","value":2884},{"code":"IIC343","value":26268},{"code":"IIC341","value":185282},{"code":"IIC335","value":554848}],"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2023-03-08T11:25:08.0331456Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}},"branches":{"numberOfBranches":1},"ecofin":{"balanceSheetDate":"2021-12-31T00:00:00","turnoverRange":{"code":"TR7","description":"1000000 - 4999999"},"turnoverYear":2021,"turnover":4432761,"turnoverTrend":5.74,"shareCapital":50000,"netWorth":563473,"enterpriseSize":{"code":"SMALL","description":"Small enterprise"}},"foreignTrade":{"isImporter":false,"isExporter":false},"corporateGroups":{"belongsToGroup":true,"groupName":"DE LUCIA - SCURIATTI","holdingCompanyName":"LUCA SCURIATTI","nationalParentCompany":{"province":{"code":"ND99","description":"N. A."}}},"operatingResults":{"ebitda":714856,"ebitdaL2Y":284656,"ebit":682714,"ebitL2Y":260414,"cashFlow":501508,"cashFlowL2Y":194476},"rae":{"code":"830","description":"SERV.FIN./IMM./FISCALI/TECNICI"},"sae":{"code":"430","description":"Imprese produttive"}},"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"302":{"description":"Found","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before trying again"},"Location":{"schema":{"type":"string"},"description":"Url to call after waiting the retry-after seconds"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"asynchronous":{"value":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"cf or piva required","error":214,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"cf/piva not valid","error":215,"data":null}}}}}},"post":{"tags":["IT"],"summary":"Aml","description":"Endpoint that allows you to asynchronously pull data from a company for anti-money laundering purposes","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostBody"},"example":{"callback":{"url":"https://your_domain.it/your_callback.php","method":"JSON","headers":{"session_id":"oiwejdf89453urf945jfg"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/Aml"}]}}}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"taxCode Required","content":{"application/json":{"example":{"success":false,"message":"taxCode or vatCode required","error":238,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode not valid","error":239,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"url not set in 'callback', required","error":704,"data":null}}}}}}},"/IT-marketing/{vatCode_or_taxCode}":{"get":{"tags":["IT"],"summary":"Marketing","description":"Call that allows you to extract data from a company for a marketing function. \n\nDuring periods of high traffic, official data sources may experience slower response times. To ensure service availability during these peak load periods or maintenance, we've implemented a 30-second timeout. Upon timeout, a unique ID is generated, allowing clients to poll for status updates. In this case an http code 302 and a Location header with address https://company.openapi.com/IT-check_id/ID are returned. The call may be automatically redirected by your system so make sure you have used a valid token for both endpoints or disable automatic redirection. \n\nHowever, we strongly recommend using the POST method to set up a callback URL. This eliminates the need for polling as our system will proactively notify you via the callback when the request is complete.","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Marketing"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"synchronous":{"value":{"data":{"pec":"OPENAPI@LEGALMAIL.IT","companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2023-03-08T11:25:08.0331456Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}},"branches":{"numberOfBranches":1},"atecoClassification":{"ateco":{"code":"6201","description":"Production of software not related to editing"},"secondaryAteco":"6202","ateco2022":{"code":"6201","description":"Production of software not related to editing"},"secondaryAteco2022":"6202"},"internationalClassification":{"nace":{"code":"6201","description":"Computer programming activities"},"primarySic":{"code":"7372","description":"Computer programming & software services"},"secondarySic":"7392, 7374"},"ecofin":{"balanceSheetDate":"2021-12-31T00:00:00","turnoverRange":{"code":"TR7","description":"1000000 - 4999999"},"turnoverYear":2021,"turnover":4432761,"turnoverTrend":5.74,"shareCapital":50000,"netWorth":563473,"enterpriseSize":{"code":"SMALL","description":"Small enterprise"}},"employees":{"employeeRange":{"code":"ER4","description":"11 - 20"},"employee":15,"employeeTrend":7.14},"employeesStatistic":{"permanentContract":100,"partialTimeContract":20,"fullTimeContract":80,"whiteCollar":100},"innovativeSmeAndSu":{"isInnovativeStartUp":false,"isInnovativeSme":false},"mail":{"email":"info@altravia.com"},"contacts":{"telephoneNumber":"0697276223;","fax":"0687420311"},"webAndSocial":{"website":"www.altravia.com","hasSocial":true,"facebook":"https://www.facebook.com/openapisrl","linkedin":"https://www.linkedin.com/company/openapi-srl/"},"corporateGroups":{"belongsToGroup":true,"groupName":"DE LUCIA - SCURIATTI","holdingCompanyName":"LUCA SCURIATTI","nationalParentCompany":{"province":{"code":"ND99","description":"N. A."}}},"allOffices":[{"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2024-05-11T20:43:21.2667304Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}}},{"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2024-05-11T20:43:21.2667304Z","cciaa":"TR","reaCode":"353472","companyName":"OPENAPI SPA","officeType":{"code":"UL","description":"Local units"},"openapiNumber":"IT93E20F0DU8001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"PIAZZA SAN GIOVANNI DECOLLATO, 6","zipCode":"05100","town":"TERNI","province":{"code":"TR","description":"TERNI"},"region":{"code":"10","description":"UMBRIA"},"country":{"code":"IT","description":"Italia"}}}]},"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"302":{"description":"Found","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before trying again"},"Location":{"schema":{"type":"string"},"description":"Url to call after waiting the retry-after seconds"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"asynchronous":{"value":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"cf or piva required","error":200,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"cf/piva not valid","error":201,"data":null}}}}}},"post":{"tags":["IT"],"summary":"Marketing","description":"Endpoint that allows you to asynchronously pull data from a company for a marketing function","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostBody"},"example":{"callback":{"url":"https://your_domain.it/your_callback.php","method":"JSON","headers":{"session_id":"oiwejdf89453urf945jfg"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/Marketing"}]}}}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"taxCode Required","content":{"application/json":{"example":{"success":false,"message":"taxCode or vatCode required","error":234,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode not valid","error":235,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"url not set in 'callback', required","error":704,"data":null}}}}}}},"/IT-stakeholders/{vatCode_or_taxCode}":{"get":{"tags":["IT"],"summary":"Stakeholders","description":"Call that allows you to extract data from a company to see all its stakeholders. \n\nDuring periods of high traffic, official data sources may experience slower response times. To ensure service availability during these peak load periods or maintenance, we've implemented a 30-second timeout. Upon timeout, a unique ID is generated, allowing clients to poll for status updates. In this case an http code 302 and a Location header with address https://company.openapi.com/IT-check_id/ID are returned. The call may be automatically redirected by your system so make sure you have used a valid token for both endpoints or disable automatic redirection. \n\nHowever, we strongly recommend using the POST method to set up a callback URL. This eliminates the need for polling as our system will proactively notify you via the callback when the request is complete.","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Stakeholders"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"synchronous":{"value":{"data":{"managers":[{"name":"LUCA","surname":"SCURIATTI","roles":[{"role":{"code":"AUN","description":"Managing director"},"roleStartDate":"2020-09-10T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"SCRLCU73R02H501H","birthDate":"1973-10-02T00:00:00","age":49,"birthTown":"ROMA (RM)","isLegalRepresentative":true},{"companyName":"OPEN HOLDING SRL","roles":[{"role":{"code":"SOU","description":"Sole owner"},"roleStartDate":"2022-12-05T00:00:00"}],"taxCode":"16935371001","isLegalRepresentative":false},{"name":"SIMONE","surname":"DESANTIS","roles":[{"role":{"code":"PP","description":"Special representative/agent"},"roleStartDate":"2013-10-17T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"DSNSMN80M11L117F","birthDate":"1980-08-11T00:00:00","age":42,"birthTown":"TERNI (TR)","isLegalRepresentative":false},{"name":"SHAUN","surname":"DE LUCIA","roles":[{"role":{"code":"PP","description":"Special representative/agent"},"roleStartDate":"2013-10-17T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"DLCSHN77S29Z114J","birthDate":"1977-11-29T00:00:00","age":45,"birthTown":"STOKE ON TRENT (E)","isLegalRepresentative":false}],"shareholders":[{"shareholdersInformation":[{"taxCode":"16935371001","openapiNumber":"IT8A380807S0001","companyName":"OPEN HOLDING SRL","sinceDate":"2022-11-23T00:00:00","streetName":"VIALE FILIPPO TOMMASO MARINETTI 221","zipCode":"00143","town":"ROMA"}],"percentShare":100}],"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2023-03-08T11:25:08.0331456Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}},"branches":{"numberOfBranches":1},"employees":{"employeeRange":{"code":"ER4","description":"11 - 20"},"employee":15,"employeeTrend":7.14},"employeesStatistic":{"permanentContract":100,"partialTimeContract":20,"fullTimeContract":80,"whiteCollar":100},"corporateGroups":{"belongsToGroup":true,"groupName":"DE LUCIA - SCURIATTI","holdingCompanyName":"LUCA SCURIATTI","nationalParentCompany":{"province":{"code":"ND99","description":"N. A."}}}},"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"302":{"description":"Found","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before trying again"},"Location":{"schema":{"type":"string"},"description":"Url to call after waiting the retry-after seconds"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"asynchronous":{"value":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"cf or piva required","error":207,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"cf/piva not valid","error":208,"data":null}}}}}},"post":{"tags":["IT"],"summary":"Stakeholders","description":"Endpoint that allows you to asynchronously pull data from a company to see all its stakeholders","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostBody"},"example":{"callback":{"url":"https://your_domain.it/your_callback.php","method":"JSON","headers":{"session_id":"oiwejdf89453urf945jfg"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/Stakeholders"}]}}}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"taxCode Required","content":{"application/json":{"example":{"success":false,"message":"taxCode or vatCode required","error":236,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode not valid","error":237,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"url not set in 'callback', required","error":704,"data":null}}}}}}},"/IT-full/{vatCode_or_taxCode}":{"get":{"tags":["IT"],"summary":"All the data","description":"The most comprehensive endpoint of the \"Company\" API.\nThis endpoint provides all available information from the other endpoints, enriched with over 400 financial details.\n\nAt this address <a href='https://docs.openapi.it/company-legend.html' target='_blank'>https://docs.openapi.it/company-legend.html</a> you will find a detailed legend with all the codes used in the API.\n\nDuring periods of high traffic, official data sources may experience slower response times. To ensure service availability during these peak load periods or maintenance, we've implemented a 30-second timeout. Upon timeout, a unique ID is generated, allowing clients to poll for status updates. In this case an http code 302 and a Location header with address https://company.openapi.com/IT-check_id/ID are returned. The call may be automatically redirected by your system so make sure you have used a valid token for both endpoints or disable automatic redirection. \n\nHowever, we strongly recommend using the POST method to set up a callback URL. This eliminates the need for polling as our system will proactively notify you via the callback when the request is complete.","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Full"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"synchronous":{"value":{"data":{"pec":"OPENAPI@LEGALMAIL.IT","publicTenders":[{"year":"2021","applied":41,"won":42,"value":13812.52},{"year":"2020","applied":48,"won":51,"value":10274.94}],"managers":[{"name":"LUCA","surname":"SCURIATTI","roles":[{"role":{"code":"AUN","description":"Managing director"},"roleStartDate":"2020-09-10T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"SCRLCU73R02H501H","birthDate":"1973-10-02T00:00:00","age":49,"birthTown":"ROMA (RM)","isLegalRepresentative":true},{"companyName":"OPEN HOLDING SRL","roles":[{"role":{"code":"SOU","description":"Sole owner"},"roleStartDate":"2022-12-05T00:00:00"}],"taxCode":"16935371001","isLegalRepresentative":false},{"name":"SIMONE","surname":"DESANTIS","roles":[{"role":{"code":"PP","description":"Special representative/agent"},"roleStartDate":"2013-10-17T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"DSNSMN80M11L117F","birthDate":"1980-08-11T00:00:00","age":42,"birthTown":"TERNI (TR)","isLegalRepresentative":false},{"name":"SHAUN","surname":"DE LUCIA","roles":[{"role":{"code":"PP","description":"Special representative/agent"},"roleStartDate":"2013-10-17T00:00:00"}],"gender":{"code":"M","description":"Man"},"taxCode":"DLCSHN77S29Z114J","birthDate":"1977-11-29T00:00:00","age":45,"birthTown":"STOKE ON TRENT (E)","isLegalRepresentative":false}],"shareholders":[{"shareholdersInformation":[{"taxCode":"16935371001","openapiNumber":"IT8A380807S0001","companyName":"OPEN HOLDING SRL","sinceDate":"2022-11-23T00:00:00","streetName":"VIALE FILIPPO TOMMASO MARINETTI 221","zipCode":"00143","town":"ROMA"}],"percentShare":100}],"adjustments":[{"code":"IIC163","value":0},{"code":"IIC162","value":0},{"code":"IIC164","value":0},{"code":"IIC246","value":0},{"code":"IIC245","value":0},{"code":"IIC350","value":0},{"code":"IICC351","value":0},{"code":"IIC167","value":0},{"code":"IIC168","value":0},{"code":"IIC166","value":0},{"code":"IIC165","value":0},{"code":"IIC169","value":0}],"productionCosts":[{"code":"IIC134","value":401153},{"code":"IIC188","value":32142},{"code":"IIC140","value":19514},{"code":"IIC141","value":12628},{"code":"IIC142","value":0},{"code":"IIC143","value":0},{"code":"IIC133","value":68393},{"code":"IIC138","value":6689},{"code":"IIC148","value":33313},{"code":"IIC147","value":0},{"code":"IIC137","value":0},{"code":"IIC131","value":9949},{"code":"IIC146","value":0},{"code":"IIC132","value":3061076},{"code":"IIC136","value":24181},{"code":"IIC187","value":30870},{"code":"IIC135","value":116838},{"code":"IIC144","value":32142},{"code":"IIC139","value":548861},{"code":"IIC145","value":0}],"revenuesFinancialCharges":[{"code":"IIC226","value":0},{"code":"IPL231","value":0},{"code":"IIC236","value":0},{"code":"IIC227","value":0},{"code":"IPL232","value":0},{"code":"IIC237","value":0},{"code":"IIC225","value":0},{"code":"IIC230","value":0},{"code":"IIC235","value":0},{"code":"IIC228","value":0},{"code":"IIC233","value":0},{"code":"IIC238","value":0},{"code":"IIC229","value":0},{"code":"IIC234","value":0},{"code":"IIC239","value":0},{"code":"IIC156","value":0},{"code":"IIC190","value":-3950},{"code":"IIC152","value":0},{"code":"IIC155","value":0},{"code":"IIC154","value":0},{"code":"IIC150","value":0},{"code":"IIC189","value":0},{"code":"IIC241","value":0},{"code":"IIC243","value":0},{"code":"IIC244","value":1445},{"code":"IIC242","value":0},{"code":"IIC240","value":0},{"code":"IIC159","value":1445},{"code":"IIC158","value":0}],"annualResult":[{"code":"IIC191","value":204454},{"code":"IIC192","value":0},{"code":"IIC250","value":0},{"code":"IIC179","value":469366},{"code":"IIC177","value":677319},{"code":"IIC347","value":3499},{"code":"IIC178","value":207953}],"incomeStatementAggregateValues":[{"code":"IIC224","value":682714},{"code":"IIC149","value":3753734},{"code":"IIC130","value":4436448},{"code":"IIC161","value":-5395},{"code":"IIC170","value":0}],"productionValue":[{"code":"IIC127","value":0},{"code":"IIC129","value":0},{"code":"IIC223","value":3687},{"code":"IIC125","value":0},{"code":"IIC124","value":4432761},{"code":"IIC128","value":3687},{"code":"IIC186","value":0},{"code":"IIC126","value":0}],"assetsAggregateValues":[{"code":"IIC072","value":77415},{"code":"IIC001","value":0},{"code":"IIC071","value":1140691},{"code":"IIC074","value":1511183},{"code":"IIC039","value":293077}],"intangibleFixedAssets":[{"code":"IIC011","value":62234}],"tangibleFixedAssets":[{"code":"IIC018","value":230843}],"cashEquivalents":[{"code":"IIC070","value":1020479}],"credits":[{"code":"IIC057","value":2865},{"code":"IIC052","value":0},{"code":"IIC053","value":0},{"code":"IIC046","value":91525},{"code":"IIC047","value":0},{"code":"IIC054","value":6363},{"code":"IIC055","value":0},{"code":"IIC050","value":0},{"code":"IIC051","value":0},{"code":"IIC048","value":0},{"code":"IIC049","value":0},{"code":"IIC198","value":0},{"code":"IIC199","value":0},{"code":"IIC056","value":113619},{"code":"IIC180","value":15731},{"code":"IIC181","value":2865},{"code":"IIC324","value":0},{"code":"IIC321","value":91525},{"code":"IIC058","value":120212},{"code":"IIC325","value":0},{"code":"IIC326","value":18596},{"code":"IIC328","value":6363},{"code":"IIC323","value":0},{"code":"IIC322","value":0},{"code":"IIC327","value":3728}],"financialFixedAssets":[{"code":"IIC026","value":0},{"code":"IIC027","value":0},{"code":"IIC029","value":0},{"code":"IIC028","value":0},{"code":"IIC025","value":0},{"code":"IIC024","value":0},{"code":"IIC030","value":0},{"code":"IIC031","value":0},{"code":"IIC197","value":0},{"code":"IIC194","value":0},{"code":"IIC033","value":0},{"code":"IIC035","value":0},{"code":"IIC020","value":0},{"code":"IIC022","value":0},{"code":"IIC021","value":0},{"code":"IIC019","value":0},{"code":"IIC195","value":0},{"code":"IIC196","value":0},{"code":"IIC032","value":0},{"code":"IIC317","value":0},{"code":"IIC318","value":0},{"code":"IIC316","value":0},{"code":"IIC034","value":0},{"code":"IIC320","value":0},{"code":"IIC038","value":0},{"code":"IIC023","value":0},{"code":"IIC319","value":0}],"creditsToShareholders":[{"code":"IIC002","value":0},{"code":"IIC193","value":0}],"financialAssets":[{"code":"IIC201","value":0},{"code":"IIC202","value":0},{"code":"IIC200","value":0},{"code":"IIC062","value":0},{"code":"IIC065","value":0},{"code":"IIC060","value":0},{"code":"IIC059","value":0},{"code":"IIC061","value":0},{"code":"IIC066","value":0}],"inventory":[{"code":"IIC043","value":0},{"code":"IIC044","value":0},{"code":"IIC040","value":0},{"code":"IIC041","value":0},{"code":"IIC349","value":0},{"code":"IIC045","value":0},{"code":"IIC042","value":0}],"debts":[{"code":"IIC099","value":0},{"code":"IIC098","value":5426},{"code":"IIC091","value":0},{"code":"IIC090","value":0},{"code":"IIC092","value":0},{"code":"IIC093","value":0},{"code":"IIC103","value":0},{"code":"IIC102","value":0},{"code":"IIC117","value":52106},{"code":"IIC097","value":38777},{"code":"IIC107","value":0},{"code":"IIC112","value":19752},{"code":"IIC113","value":0},{"code":"IIC109","value":0},{"code":"IIC105","value":0},{"code":"IIC220","value":0},{"code":"IIC221","value":0},{"code":"IIC106","value":0},{"code":"IIC094","value":2884},{"code":"IIC095","value":0},{"code":"IIC096","value":0},{"code":"IIC108","value":0},{"code":"IIC185","value":0},{"code":"IIC184","value":0},{"code":"IIC104","value":0},{"code":"IIC101","value":0},{"code":"IIC100","value":554848},{"code":"IIC114","value":26268},{"code":"IIC115","value":0},{"code":"IIC116","value":781131},{"code":"IIC110","value":171953},{"code":"IIC111","value":13329},{"code":"IIC334","value":5426},{"code":"IIC329","value":0},{"code":"IIC333","value":38777},{"code":"IIC338","value":0},{"code":"IIC337","value":0},{"code":"IIC330","value":0},{"code":"IIC336","value":0},{"code":"IIC342","value":19752},{"code":"IIC340","value":0},{"code":"IIC339","value":0},{"code":"IIC331","value":0},{"code":"IIC332","value":2884},{"code":"IIC343","value":26268},{"code":"IIC341","value":185282},{"code":"IIC335","value":554848}],"liabilitiesAggregateValues":[{"code":"IIC119","value":45616},{"code":"IIC089","value":68857},{"code":"IIC118","value":833237},{"code":"IIC121","value":1511183},{"code":"IIC084","value":563473},{"code":"IIC088","value":0}],"netWorth":[{"code":"IIC211","value":0},{"code":"IIC207","value":0},{"code":"IIC209","value":0},{"code":"IIC210","value":0},{"code":"IIC208","value":0},{"code":"IIC203","value":7069},{"code":"IIC206","value":0},{"code":"IIC078","value":10000},{"code":"IIC212","value":0},{"code":"IIC216","value":0},{"code":"IIC214","value":1},{"code":"IIC218","value":0},{"code":"IIC081","value":7069},{"code":"IIC082","value":0},{"code":"IIC083","value":469366},{"code":"IIC345","value":0},{"code":"IIC204","value":0},{"code":"IIC213","value":0},{"code":"IIC215","value":0},{"code":"IIC077","value":27038},{"code":"IIC075","value":50000},{"code":"IIC076","value":0},{"code":"IIC205","value":0},{"code":"IIC080","value":0}],"riskProvisions":[{"code":"IIC087","value":0},{"code":"IIC219","value":0},{"code":"IIC085","value":0},{"code":"IIC086","value":0}],"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2023-03-08T11:25:08.0331456Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"legalForm":{"legalForm":{"code":"SC","description":"Joint stock business"},"detailedLegalForm":{"code":"SR","description":"Limited liability company/ limited company"}},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"companyDates":{"registrationDate":"2013-07-19T00:00:00","startDate":"2013-10-20T00:00:00","incorporationDate":"2013-07-11T00:00:00"},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}},"marketable":{"isMarketable":true},"branches":{"numberOfBranches":1},"atecoClassification":{"ateco":{"code":"6201","description":"Production of software not related to editing"},"secondaryAteco":"6202","ateco2022":{"code":"6201","description":"Production of software not related to editing"},"secondaryAteco2022":"6202"},"internationalClassification":{"nace":{"code":"6201","description":"Computer programming activities"},"primarySic":{"code":"7372","description":"Computer programming & software services"},"secondarySic":"7392, 7374"},"ecofin":{"balanceSheetDate":"2021-12-31T00:00:00","turnoverRange":{"code":"TR7","description":"1000000 - 4999999"},"turnoverYear":2021,"turnover":4432761,"turnoverTrend":5.74,"shareCapital":50000,"netWorth":563473,"enterpriseSize":{"code":"SMALL","description":"Small enterprise"}},"employees":{"employeeRange":{"code":"ER4","description":"11 - 20"},"employee":15,"employeeTrend":7.14},"employeesStatistic":{"permanentContract":100,"partialTimeContract":20,"fullTimeContract":80,"whiteCollar":100},"innovativeSmeAndSu":{"isInnovativeStartUp":false,"isInnovativeSme":false},"mail":{"email":"info@altravia.com"},"contacts":{"telephoneNumber":"0697276223;","fax":"0687420311"},"webAndSocial":{"website":"www.altravia.com","hasSocial":true,"facebook":"https://www.facebook.com/openapisrl","linkedin":"https://www.linkedin.com/company/openapi-srl/"},"foreignTrade":{"isImporter":false,"isExporter":false},"corporateGroups":{"belongsToGroup":true,"groupName":"DE LUCIA - SCURIATTI","holdingCompanyName":"LUCA SCURIATTI","nationalParentCompany":{"province":{"code":"ND99","description":"N. A."}}},"artisanBusinessRegistry":{"belongsToArtisanBusinessRegistry":false},"soaCertification":{"hasSoaCertification":false},"financialCycle":{"accountsReceivableDuration":7.53,"stockDuration":0,"debtsToSuppliersDuration":64.5086,"financialCycleDuration":-56.9786},"coverageRatios":{"ebitdaNetInterestCoverage":494.71,"ebitNetInterestCoverage":472.4664,"ebitdaGrossInterestCoverage":494.71,"ebitGrossInterestCoverage":472.4664},"efficiency":{"turnoverIndex":2.9358,"currentAssetsRotation":3.6619,"accountsReceivableRotation":48.4725},"leverageRatios":{"pfnEbitda":-1.3693,"ebitdaNetLeverage":-1.3693,"ebitdaGrossLeverage":0.0583},"liquidityRatios":{"cashShortTermFinancialDebt":353.8415,"cashShortTermBankDebt":353.8415,"cashTotalShortTermDebt":1.3064},"profitability":{"ros":15.39,"roe":83.3,"incidenceOfExtraFeaturesManagement":68.75,"roi":45.18,"roaMonetary":33.19},"financialBurden":{"rod":0.17,"rodFinanziario":3.47,"burdenIndex":0.2},"indebtedness":{"bankDebtTotalAssets":0.0019,"capitalizationDegree":0.3729,"leverage":2.6819,"bankDebtRatio":0.0051,"debtRatio":1.4788},"financialStability":{"secondaryMarginStructure ":315909,"marginStructure":1.8803,"fixedAssetsCoverageRate":2.0542,"marginStructureIndex":263803,"workingCapitalCoverage":0.0867,"acidTest":1.4654,"currentRatio":1.4654},"structureRatios":{"netFinancialDebtEquityNetWorth":-1.7371,"pfnNetWorth":-1.7371,"financialDebtComposition":0.0692,"grossFinancialDebtNetWorth":0.0739},"development":{"ebitVariation":1.6217,"grossFinancialDebt":-0.1394,"totalAssets":-12.38,"mol":151.13,"addedValue":60.01,"productionValue":4.48},"operatingResults":{"ebitda":714856,"ebitdaL2Y":284656,"ebit":682714,"ebitL2Y":260414,"cashFlow":501508,"cashFlowL2Y":194476},"financialStatementKpi":{"totalInventoryTurnover":0,"debtsTurnover":0.188},"rae":{"code":"830","description":"SERV.FIN./IMM./FISCALI/TECNICI"},"sae":{"code":"430","description":"Imprese produttive"},"allOffices":[{"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2024-05-11T20:43:21.2667304Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}}},{"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2024-05-11T20:43:21.2667304Z","cciaa":"TR","reaCode":"353472","companyName":"OPENAPI SPA","officeType":{"code":"UL","description":"Local units"},"openapiNumber":"IT93E20F0DU8001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"PIAZZA SAN GIOVANNI DECOLLATO, 6","zipCode":"05100","town":"TERNI","province":{"code":"TR","description":"TERNI"},"region":{"code":"10","description":"UMBRIA"},"country":{"code":"IT","description":"Italia"}}}]},"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"302":{"description":"Found","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before trying again"},"Location":{"schema":{"type":"string"},"description":"Url to call after waiting the retry-after seconds"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"asynchronous":{"value":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"cf or piva required","error":221,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"cf/piva not valid","error":222,"data":null}}}}}},"post":{"tags":["IT"],"summary":"Full","description":"Endpoint that allows you to asynchronously pull all available information from the other endpoints, enriched with over 400 financial details.","parameters":[{"name":"vatCode_or_taxCode","in":"path","description":"vat code or tax code","required":true,"schema":{"type":"string","example":"12485671007"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostBody"},"example":{"callback":{"url":"https://your_domain.it/your_callback.php","method":"JSON","headers":{"session_id":"oiwejdf89453urf945jfg"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/Full"}]}}}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Request"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"taxCode Required","content":{"application/json":{"example":{"success":false,"message":"taxCode or vatCode required","error":240,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode not valid","error":241,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"url not set in 'callback', required","error":704,"data":null}}}}}}},"/IT-check_id/{id}":{"get":{"tags":["IT"],"summary":"Check request","description":"This enpoint allows you to check an asynchronous request, when it is complete it shows you the requested company data.","parameters":[{"name":"id","in":"path","description":"Request ID","required":true,"schema":{"type":"string","example":"66a8ed9b82cf2ae627012068"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/Marketing"},{"$ref":"#/components/schemas/Aml"},{"$ref":"#/components/schemas/Stakeholders"},{"$ref":"#/components/schemas/Full"},{"type":"object","properties":{"state":{"type":"string"},"id":{"type":"string"}}}]},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"PENDING":{"value":{"data":{"state":"PENDING","id":"66a8ed9b82cf2ae627012068"},"success":true,"message":"","error":null}},"DONE":{"value":{"data":{"pec":"OPENAPI@LEGALMAIL.IT","companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2023-03-08T11:25:08.0331456Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}},"branches":{"numberOfBranches":1},"atecoClassification":{"ateco":{"code":"6201","description":"Production of software not related to editing"},"secondaryAteco":"6202","ateco2022":{"code":"6201","description":"Production of software not related to editing"},"secondaryAteco2022":"6202"},"internationalClassification":{"nace":{"code":"6201","description":"Computer programming activities"},"primarySic":{"code":"7372","description":"Computer programming & software services"},"secondarySic":"7392, 7374"},"ecofin":{"balanceSheetDate":"2021-12-31T00:00:00","turnoverRange":{"code":"TR7","description":"1000000 - 4999999"},"turnoverYear":2021,"turnover":4432761,"turnoverTrend":5.74,"shareCapital":50000,"netWorth":563473,"enterpriseSize":{"code":"SMALL","description":"Small enterprise"}},"employees":{"employeeRange":{"code":"ER4","description":"11 - 20"},"employee":15,"employeeTrend":7.14},"employeesStatistic":{"permanentContract":100,"partialTimeContract":20,"fullTimeContract":80,"whiteCollar":100},"innovativeSmeAndSu":{"isInnovativeStartUp":false,"isInnovativeSme":false},"mail":{"email":"info@altravia.com"},"contacts":{"telephoneNumber":"0697276223;","fax":"0687420311"},"webAndSocial":{"website":"www.altravia.com","hasSocial":true,"facebook":"https://www.facebook.com/openapisrl","linkedin":"https://www.linkedin.com/company/openapi-srl/"},"corporateGroups":{"belongsToGroup":true,"groupName":"DE LUCIA - SCURIATTI","holdingCompanyName":"LUCA SCURIATTI","nationalParentCompany":{"province":{"code":"ND99","description":"N. A."}}},"allOffices":[{"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2024-05-11T20:43:21.2667304Z","cciaa":"RM","reaCode":"1378273","companyName":"OPENAPI SPA","officeType":{"code":"SSL","description":"Administrative headquarter and registered office"},"openapiNumber":"IT93E20F0DS0001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"VIALE FILIPPO TOMMASO MARINETTI, 221","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"ROMA"},"region":{"code":"12","description":"LAZIO"},"country":{"code":"IT","description":"Italia"}}},{"companyDetails":{"vatCode":"12485671007","taxCode":"12485671007","lastUpdateDate":"2024-05-11T20:43:21.2667304Z","cciaa":"TR","reaCode":"353472","companyName":"OPENAPI SPA","officeType":{"code":"UL","description":"Local units"},"openapiNumber":"IT93E20F0DU8001"},"companyStatus":{"activityStatus":{"code":"A","description":"Enable"}},"address":{"streetName":"PIAZZA SAN GIOVANNI DECOLLATO, 6","zipCode":"05100","town":"TERNI","province":{"code":"TR","description":"TERNI"},"region":{"code":"10","description":"UMBRIA"},"country":{"code":"IT","description":"Italia"}}}]},"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"id required","error":242,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no request matches this id: ","error":244,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"id not valid","error":243,"data":null}}}}}}},"/IT-start/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Start"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"activityStatus":"ATTIVA","creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"sdiCode":"USAL8PV","sdiCodeTimestamp":1622452306,"id":"60b4a85585e34e615c569ef5","registrationDate":"2013-07-19"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":300,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":302,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":301,"data":null}}}}}}},"/IT-advanced/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as ateco code, balance sheet and pec.","parameters":[{"name":"vatCode_taxCode_or_id","required":true,"in":"path","description":"VAT number, tax code or ID","schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Advanced"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"activityStatus":"ATTIVA","reaCode":"1378273","cciaa":"RM","atecoClassification":{"ateco":{"code":"621","description":"Attività di programmazione informatica"},"ateco2022":{"code":"6201","description":"Produzione di software non connesso all'edizione"},"ateco2007":{"code":"6201","description":"Produzione di software non connesso all'edizione"}},"detailedLegalForm":{"code":"SP","description":"SOCIETA' PER AZIONI"},"startDate":"2013-10-20","registrationDate":"2013-07-19","endDate":null,"pec":"openapi@legalmail.it","cessata":false,"taxCodeCeased":1622452306,"taxCodeCeasedTimestamp":1622452306,"gruppo_iva":{"vatGroupParticipation":false,"isVatGroupLeader":false,"registryOk":true},"sdiCode":"USAL8PV","sdiCodeTimestamp":1622452306,"creationTimestamp":1624358855,"lastUpdateTimestamp":1708705000,"balanceSheets":{"last":{"year":2022,"employees":14,"balanceSheetDate":"2022-12-31","turnover":4043407,"netWorth":166491,"shareCapital":50000,"totalStaffCost":604997,"totalAssets":1483126,"avgGrossSalary":43214.07142857143},"all":[{"year":2024,"employees":15,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":50000},{"year":2023,"employees":15,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":50000},{"year":2022,"employees":14,"balanceSheetDate":"2022-12-31","turnover":4043407,"netWorth":166491,"shareCapital":50000,"totalStaffCost":604997,"totalAssets":1483126,"avgGrossSalary":43214.07142857143},{"year":2021,"employees":15,"balanceSheetDate":"2021-12-31","turnover":4432761,"netWorth":469366,"shareCapital":50000},{"year":2020,"employees":14,"balanceSheetDate":"2020-12-31","turnover":4192138,"netWorth":170234,"shareCapital":10000},{"year":2019,"employees":14,"balanceSheetDate":"2019-12-31","turnover":1799587,"netWorth":11309,"shareCapital":10000},{"year":2018,"employees":null,"balanceSheetDate":"2018-12-31","turnover":1325358,"netWorth":826,"shareCapital":null},{"year":2017,"employees":null,"balanceSheetDate":"2017-12-31","turnover":1120176,"netWorth":2928,"shareCapital":null}]},"shareHolders":[{"companyName":"OPEN HOLDING S.R.L.","name":null,"surname":null,"taxCode":"16935371001","percentShare":100}],"id":"60d1bfc731177b0a092cdfc1"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":303,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":305,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":304,"data":null}}}}}}},"/IT-search":{"get":{"tags":["IT"],"summary":"Advanced search and data","description":"With this endpoint we can draw up a list of companies that correspond to certain parameters described below. The call returns a maximum of 1000 results even if you set a higher limit.","parameters":[{"name":"dryRun","required":false,"in":"query","description":"simulates a request by returning only the number of records found and the price","schema":{"type":"integer","example":0,"enum":[1,0]}},{"name":"dataEnrichment","required":false,"in":"query","description":"with this parameter you can decide how to enrich the output data; if it is not set the call will return only the ids","schema":{"type":"string","example":"start","enum":["start","advanced","pec","address","shareholders","name"]}},{"name":"lat","required":false,"in":"query","description":"latitude","schema":{"type":"number","format":"double","minimum":-90,"maximum":90,"exclusiveMinimum":false,"exclusiveMaximum":false,"example":13.5478}},{"name":"long","required":false,"in":"query","description":"longitude","schema":{"type":"number","format":"double","minimum":-180,"maximum":180,"exclusiveMinimum":false,"exclusiveMaximum":false,"example":42.859}},{"name":"radius","required":false,"in":"query","description":"radius in meters","schema":{"type":"integer","minimum":0,"exclusiveMinimum":true,"example":100}},{"name":"companyName","required":false,"in":"query","description":"A search query; you can enter the company name (you can search for parts of the name as long as they are whole words) or alternatively '*' can be used as a wildcard to search for strings that start, contain or end with the given query. This search works with at least 3 characters.","schema":{"type":"string"},"examples":{"startsWith":{"value":"openapi*","summary":"Starts with"},"endsWith":{"value":"*openapi","summary":"Ends with"},"contains":{"value":"openapi","summary":"Contains"}}},{"name":"autocomplete","required":false,"in":"query","description":"is used to search for strings that begin with the specified query","schema":{"type":"string","example":"opena"}},{"name":"province","required":false,"in":"query","description":"the province code for which you want to carry out the search","schema":{"type":"string","example":"RM"}},{"name":"townCode","required":false,"in":"query","description":"the cadastral code (also known as national code or Belfiore code) for which you want to carry out the search","schema":{"type":"string","example":"H501"}},{"name":"atecoCode","required":false,"in":"query","description":"ateco code","schema":{"type":"string","example":"6201"}},{"name":"cciaa","required":false,"in":"query","description":"Chamber of Commerce","schema":{"type":"string","example":"RM"}},{"name":"reaCode","required":false,"in":"query","description":"rea code","schema":{"type":"string","example":"1378273"}},{"name":"minTurnover","required":false,"in":"query","description":"minimum turnover value","schema":{"type":"integer","example":100000}},{"name":"maxTurnover","required":false,"in":"query","description":"maximum turnover value","schema":{"type":"integer","example":1000000}},{"name":"minEmployees","required":false,"in":"query","description":"minimum value of employees","schema":{"type":"integer","example":1}},{"name":"maxEmployees","required":false,"in":"query","description":"maximum value of employees","schema":{"type":"integer","example":5}},{"name":"sdiCode","required":false,"in":"query","description":"sdi code","schema":{"type":"string","example":"USAL8PV"}},{"name":"legalFormCode","required":false,"in":"query","description":"legal form code","schema":{"type":"string","example":"SP"}},{"name":"shareHolderTaxCode","required":false,"in":"query","description":"tax code of a company member","schema":{"type":"string","example":"16935371001"}},{"name":"activityStatus","required":false,"in":"query","description":"status of the company in the chamber of commerce","schema":{"type":"string","example":"ATTIVA","enum":["ATTIVA","CESSATA","REGISTRATA","INATTIVA","SOSPESA","IN_ISCRIZIONE"]}},{"name":"pec","required":false,"in":"query","description":"company pec","schema":{"type":"string","example":"openapi@legalmail.it"}},{"name":"creationTimestamp","required":false,"in":"query","description":"all companies created after the value","schema":{"type":"integer","example":1624358855}},{"name":"lastUpdateTimestamp","required":false,"in":"query","description":"all companies whose last update is after the value","schema":{"type":"integer","example":1724399853}},{"name":"skip","required":false,"in":"query","description":"to set the number of records you want to skip from the result set","schema":{"type":"integer","example":50}},{"name":"limit","required":false,"in":"query","description":"number of results you want to receive; if not set, the call will return a maximum of 1000 results","schema":{"type":"integer","example":10,"minimum":1,"maximum":1000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/Start"},{"$ref":"#/components/schemas/Advanced"},{"$ref":"#/components/schemas/DataEnrichmentAddress"},{"$ref":"#/components/schemas/DataEnrichmentPec"},{"$ref":"#/components/schemas/DataEnrichmentShareholders"},{"$ref":"#/components/schemas/Name"},{"type":"object","properties":{"id":{"type":"string"}}}]}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"NoEnrichment":{"value":{"data":[{"id":"60d1bfc731177b0a092cdfc1"},{"id":"45d1bfc788174b9u092cdtr5"}],"success":true,"message":"","error":null}},"Start":{"value":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"activityStatus":"ATTIVA","creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"sdiCode":"USAL8PV","sdiCodeTimestamp":1622452306,"id":"60b4a85585e34e615c569ef5","registrationDate":"2013-07-19"},{"taxCode":"12345678910","companyName":"OPENAPI TEST S.P.A.","vatCode":"12345678910","address":{"registeredOffice":{"toponym":"VIALE","street":"ROMANITA","streetNumber":"11","streetName":"VIALE ROMANITA 11","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[13.47866,41.9072]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"activityStatus":"REGISTRATA","creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"sdiCode":"USAL8PV","sdiCodeTimestamp":1622452306,"id":"45d1bfc788174b9u092cdtr5","registrationDate":"2016-06-29"}],"success":true,"message":"","error":null}},"Advanced":{"value":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"activityStatus":"ATTIVA","reaCode":"1378273","cciaa":"RM","atecoClassification":{"ateco":{"code":"621","description":"Attività di programmazione informatica"},"ateco2022":{"code":"6201","description":"Produzione di software non connesso all'edizione"},"ateco2007":{"code":"6201","description":"Produzione di software non connesso all'edizione"}},"detailedLegalForm":{"code":"SP","description":"SOCIETA' PER AZIONI"},"startDate":"2013-10-20","registrationDate":"2013-07-19","endDate":null,"pec":"openapi@legalmail.it","cessata":false,"taxCodeCeased":1622452306,"taxCodeCeasedTimestamp":1622452306,"gruppo_iva":{"vatGroupParticipation":false,"isVatGroupLeader":false,"registryOk":true},"sdiCode":"USAL8PV","sdiCodeTimestamp":1622452306,"creationTimestamp":1624358855,"lastUpdateTimestamp":1708705000,"balanceSheets":{"last":{"year":2022,"employees":14,"balanceSheetDate":"2022-12-31","turnover":4043407,"netWorth":166491,"shareCapital":50000,"totalStaffCost":604997,"totalAssets":1483126,"avgGrossSalary":43214.07142857143},"all":[{"year":2024,"employees":15,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":50000},{"year":2023,"employees":15,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":50000},{"year":2022,"employees":14,"balanceSheetDate":"2022-12-31","turnover":4043407,"netWorth":166491,"shareCapital":50000,"totalStaffCost":604997,"totalAssets":1483126,"avgGrossSalary":43214.07142857143},{"year":2021,"employees":15,"balanceSheetDate":"2021-12-31","turnover":4432761,"netWorth":469366,"shareCapital":50000},{"year":2020,"employees":14,"balanceSheetDate":"2020-12-31","turnover":4192138,"netWorth":170234,"shareCapital":10000},{"year":2019,"employees":14,"balanceSheetDate":"2019-12-31","turnover":1799587,"netWorth":11309,"shareCapital":10000},{"year":2018,"employees":null,"balanceSheetDate":"2018-12-31","turnover":1325358,"netWorth":826,"shareCapital":null},{"year":2017,"employees":null,"balanceSheetDate":"2017-12-31","turnover":1120176,"netWorth":2928,"shareCapital":null}]},"shareHolders":[{"companyName":"OPEN HOLDING S.R.L.","name":null,"surname":null,"taxCode":"16935371001","percentShare":100}],"id":"60d1bfc731177b0a092cdfc1"},{"taxCode":"12345678910","companyName":"OPENAPI TEST S.P.A.","vatCode":"12345678910","address":{"registeredOffice":{"toponym":"VIALE","street":"ROMANITA","streetNumber":"11","streetName":"VIALE ROMANITA 11","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[13.47866,41.9072]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"activityStatus":"REGISTRATA","reaCode":"2366289","cciaa":"RM","atecoClassification":{"ateco":{"code":"621","description":"Attività di programmazione informatica"},"ateco2022":{"code":"6201","description":"Produzione di software non connesso all'edizione"},"ateco2007":{"code":"6201","description":"Produzione di software non connesso all'edizione"}},"detailedLegalForm":{"code":"SP","description":"SOCIETA' PER AZIONI"},"startDate":"2016-10-225","registrationDate":"2016-06-11","endDate":null,"pec":"openapitest@legalmail.it","cessata":false,"taxCodeCeased":1622452306,"taxCodeCeasedTimestamp":1622452306,"gruppo_iva":{"vatGroupParticipation":false,"isVatGroupLeader":false,"registryOk":true},"sdiCode":"USAL8PV","sdiCodeTimestamp":1622452306,"creationTimestamp":1624358855,"lastUpdateTimestamp":1708705000,"balanceSheets":{"last":{"year":2021,"employees":5,"balanceSheetDate":"2021-12-31","turnover":345678,"netWorth":145678,"shareCapital":20000,"totalStaffCost":213330,"totalAssets":1083126,"avgGrossSalary":42666.087654343},"all":[{"year":2024,"employees":6,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":30000},{"year":2023,"employees":6,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":30000},{"year":2022,"employees":5,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":20000},{"year":2021,"employees":5,"balanceSheetDate":"2021-12-31","turnover":345678,"netWorth":145678,"shareCapital":20000,"totalStaffCost":213330,"totalAssets":1083126,"avgGrossSalary":42666.087654343}]},"shareHolders":[],"id":"45d1bfc788174b9u092cdtr5"}],"success":true,"message":"","error":null}},"Address":{"value":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"id":"60b4a85585e34e615c569ef5"},{"taxCode":"12345678910","companyName":"OPENAPI TEST S.P.A.","vatCode":"12345678910","address":{"registeredOffice":{"toponym":"VIALE","street":"ROMANITA","streetNumber":"11","streetName":"VIALE ROMANITA 11","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[13.47866,41.9072]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"id":"45d1bfc788174b9u092cdtr5"}],"success":true,"message":"","error":null}},"Pec":{"value":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","id":"60b4a85585e34e615c569ef5","pec":"openapi@legalmail.it","history":[{"pec":"altraviaservizi@legalmail.it","timestamp":1623759855}]},{"taxCode":"12345678910","companyName":"OPENAPI TEST S.P.A.","vatCode":"12345678910","id":"45d1bfc788174b9u092cdtr5","pec":"openapitest@legalmail.it","history":[]}],"success":true,"message":"","error":null}},"Shareholders":{"value":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","id":"60b4a85585e34e615c569ef5","shareHolders":[{"companyName":"OPEN HOLDING S.R.L.","name":null,"surname":null,"taxCode":"16935371001","percentShare":100}]},{"taxCode":"12345678910","companyName":"OPENAPI TEST S.P.A.","vatCode":"12345678910","id":"45d1bfc788174b9u092cdtr5","shareHolders":[]}],"success":true,"message":"","error":null}},"Name":{"value":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"town":"ROMA"}},"creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"id":"60b4a85585e34e615c569ef5"},{"taxCode":"12345678910","companyName":"OPENAPI TEST S.P.A.","vatCode":"12345678910","address":{"registeredOffice":{"town":"ROMA"}},"creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"id":"45d1bfc788174b9u092cdtr5"}],"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"you have not passed any search parameters","error":309,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"pec not valid","error":316,"data":null}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"example":{"success":false,"message":"invalid parameter, set 'lat' between -90 and 90","error":311,"data":null}}}}}}},"/IT-shareholders/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Shareholders of a company","description":"This endpoint returns the list of shareholders of a company who have a share of the company greater than 10 percent.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShareHolders"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"companyName":"OPEN HOLDING S.R.L.","name":null,"surname":null,"taxCode":"16935371001","percentShare":100}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":306,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":307,"data":null}}}}}}},"/IT-address/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Company address","description":"This endpoint returns the company address.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"taxCode":{"type":"string"},"companyName":{"type":"string"},"vatCode":{"type":"string"},"address":{"$ref":"#/components/schemas/Address"},"creationTimestamp":{"type":"integer"},"lastUpdateTimestamp":{"type":"integer"},"id":{"type":"string"}}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"townCode":"H501","region":{"code":"12","description":"LAZIO"}}},"creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"id":"60b4a85585e34e615c569ef5"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":318,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":319,"data":null}}}}}}},"/IT-pec/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Certified e-mail","description":"Starting from a VAT number, Tax code or id extracts the pec of the company.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Pec"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"pec":"openapi@legalmail.it","history":[{"pec":"altraviaservizi@legalmail.it","timestamp":1623759855}]}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":321,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":323,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":322,"data":null}}}}}}},"/IT-closed/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Cessation of activity","description":"Simple endpoint to understand in real time if a VAT number has ceased or not according to the Tax Office.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or ID","required":true,"schema":{"type":"string","example":"12485671007"}},{"name":"date","required":false,"in":"query","description":"end date","schema":{"type":"string","format":"date","example":"2022-04-18"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Closed"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"taxCodeCeased":false,"id":"60d1bfc731177b0a092cdfc1"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":324,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":327,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":325,"data":null}}}}}}},"/IT-vatgroup/{vatCode_or_id}":{"get":{"tags":["IT"],"summary":"Membership of a VAT group","description":"From this endpoint you can understand if a company is part of a VAT group and if the tax code is consistent with the VAT number taken as input.","parameters":[{"name":"vatCode_or_id","in":"path","description":"VAT number or id","required":true,"schema":{"type":"string","example":"12485671007"}},{"name":"taxCode","in":"query","required":false,"description":"if a tax code is given, this service will return additional information about the relationship between the VAT group and the tax code","schema":{"type":"string","example":"12345678910"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","oneOf":[{"$ref":"#/components/schemas/VatGroup"},{"$ref":"#/components/schemas/VatGroupTaxCode"}]}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"without taxCode":{"value":{"data":[{"vatGroupParticipation":false,"isVatGroupLeader":false,"registryOk":true}],"success":true,"message":"","error":null}},"with taxCode":{"value":{"data":[{"vatGroupParticipation":false,"isVatGroupLeader":false,"registryOk":true,"taxCodeVatCodeConsistent":false,"taxCodeEntrant":false,"taxCodePresent":false,"vatGroupMembers":[]}],"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id or vatCode required","error":328,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":332,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode not valid","error":330,"data":null}}}}}}},"/IT-sdicode/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"SDI code of a company","description":"This endpoint returns the company's SDI code updated in real time.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Sdi"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"sdiCode":"USAL8PV","id":"60d1bfc731177b0a092cdfc1"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":333,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":335,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":334,"data":null}}}}}}},"/IT-legalforms":{"get":{"tags":["IT"],"summary":"All legal forms","description":"With this endpoint you can see all the legal forms registered.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/LegalForms"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"code":"AA","description":"SOCIETA' IN ACCOMANDITA PER AZIONI"},{"code":"AN","description":"SOCIETA' CONSORTILE IN NOME COLLETTIVO"},{"code":"EI","description":"ENTE IMPRESA"},{"code":"RR","description":"SOCIETA' A RESPONSABILITA' LIMITATA A CAPITALE RIDOTTO"}],"success":true,"message":"","error":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}}}}},"/IT-legalforms/{code}":{"get":{"tags":["IT"],"summary":"Specific legal form","description":"With this endpoint you can see the value of the legal code passed as a parameter.","parameters":[{"name":"code","in":"path","description":"legal code","required":true,"schema":{"type":"string","example":"SP"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/LegalForms"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"code":"SP","description":"SOCIETA' PER AZIONI"}],"success":true,"message":"","error":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no legalform matches this code: ","error":336,"data":null}}}}}}},"/EU-start/{vatCode_taxCode}":{"get":{"tags":["EU"],"summary":"Basic data","description":"This endpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_taxCode","in":"path","description":"vat code ora tax code; the vat code must be preceded by one of the following European state codes: AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, GB, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK","required":true,"schema":{"type":"string","example":"IE6388047V"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EuStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"valid":true,"formatValid":true,"countryCode":"IE","vatCode":"6388047V","companyName":"GOOGLE IRELAND LIMITED","companyAddress":"3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"countryCode and vatCode required","error":400,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"countryCode not valid","error":401,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"internal error, service not available at the moment","error":404,"data":null}}}}}}},"/IT-splitpayment/{taxCode_vatCode}":{"get":{"tags":["IT"],"summary":"A specific split-payment company","description":"This endpoint returns the data of the split payment company identified by tax code.","parameters":[{"name":"taxCode_vatCode","in":"path","description":"tax code or vat code","required":true,"schema":{"type":"string","example":"00081070591"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Split"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"taxCode":"00081070591","companyName":"SIXX SOCIETA'ITALIANA OLEODOTXX DI GXXTA SPA IN AMM.NE STRAOXXXXARIA","startingDateTimestamp":1697760000,"companyType":"Societa' controllate di fatto dalla Presidenza del Consiglio dei Ministri e dai Ministeri","lastUpdateTimestamp":1712010603}],"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"taxCode or vatCode required","error":500,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company found","error":502,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode not valid","error":501,"data":null}}}}}}},"/IT-pa/{taxCode_vatCode}":{"get":{"tags":["IT"],"summary":"A specific public administration company","description":"This endpoint returns the data of the public administration identified by tax code or vat code.","parameters":[{"name":"taxCode_vatCode","in":"path","description":"tax code or vat code","required":true,"schema":{"type":"string","example":"01998780892"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Pa"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"paId":103356690953038300,"companyName":"PARCO ARCHEOLOGICO E PAESXXXXTICO DI SIRACUXX, ELORO, VILLA DEL TELLXXX E AKRAI","taxCode":"01998XXX892","vatCode":"01998XXX892","establishmentDate":"2019-04-11","terminationDate":null,"phone":null,"fax":null,"url":null,"managerName":"ANTOXXO","managerSurname":"MXXO","managerTitle":"LEGALE RAPPRESENTANTE","participationStatus":"N","siopeEntityCode":"03261XXX3","siopeTypeId":"46964821XXXX567XX1","siopeTypeCode":"06","siopeTypeDescription":"TUTELA E VALORIZZXXXONE DEI BENI E DELLE AXXIVITA' CULTURALI - ENTI STRUM. CONT. FINANZ","siopeInclusionDate":"2020-10-27","siopeExclusionDate":null,"ipaEntityCode":"PXXEVT","ipaCategoryId":"1179XXX20517202XXX","ipaCategoryCode":"L38","ipaCategoryDescription":"PARCHI NAZIONALI, CXXXORZI E ENTI GESTOXX DI PARCHI E AREE NATURALI PROTETTE","ipaTypeCode":"PA","ipaTypeDescription":"PUBBLICHE AMMINISTRAZIONI","ipaInclusionDate":"2019-08-27","ipaExclusionDate":null,"miurEntityCode":null,"miurTypeId":null,"miurTypeCode":null,"miurTypeDescription":null,"dtTypeId":null,"dtTypeCode":null,"dtTypeDescription":null,"ssnEntityCode":null,"s13IstatEntityCode":"32XXX613","s13IstatTypeId":"64864XXXX517942302","s13IstatTypeCode":"219","s13IstatTypeDescription":"CONSORZI E ENTI GESTXXX DI PARCHI E AREE NATURXXX PROTETTE","s13IstatInclusionDate":"2020-10-23","s13IstatExclusionDate":null,"dlgs1182011TypeId":"44954XXX061XXX9201","dlgs1182011TypeCode":"ESCFXX","dlgs1182011TypeDescription":"ENTI STRUMENTALI IN CONTABILXXX' FINANZIARIA INTEGRATA PER LA TUTXXX E VALORIZZAZIONE DEI BENI ED ATTXXITA' CULTURALI","dlgs1182011InclusionDate":"2020-10-27","dlgs1182011ExclusionDate":"\r","lastUpdateTimestamp":1712070443,"pa":true,"paInvoicingOffice":[{"administrationCode":"pasxxt","ouCode":"Uff_eFatturaPA","sdiCode":"UFAXXX","ouDescription":"Uff_eFatturaPA","region":"Sicilia","province":"SR","town":"Siracusa","streetName":"Viale Txxxrito, 66","zipCode":"96100","taxCode":"0XX9878XXX2","taxCodeVerificationDate":"2019-08-09","sfeStartDate":"2015-03-31","lastUpdateTimestamp":1712070443}],"atecoClassification":{"ateco":{"code":"9XXX00","description":"Gestione di luoghi e monumenti storici e attrazioni simili"}},"detailedLegalForm":{"code":"2XX1","description":"Ente parco"},"address":{"registeredOffice":{"town":{"code":"I754","number":"017","description":"SIRACUSA","istat":"089017"},"province":{"code":"SR","number":"089","description":"SIRACUSA"},"zipCode":"96100","toponym":null,"hamlet":null,"streetNumber":null,"street":null,"streetName":"VIALE TXXXXITO, 66","region":{"code":"19","description":"SICILIA"},"area":{"code":"5","description":"ISOLE"}}}}],"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"taxCode or vatCode required","error":600,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company found","error":602,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode not valid","error":601,"data":null}}}}}}},"/IT-name/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and town.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Name"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"taxCode":"12485671007","companyName":"OPENAPI S.P.A.","vatCode":"12485671007","address":{"registeredOffice":{"town":"ROMA"}},"creationTimestamp":1622452306,"lastUpdateTimestamp":1622452306,"id":"60b4a85585e34e615c569ef5"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":339,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":341,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":340,"data":null}}}}}}},"/IT-ubo/{vatCode_taxCode_or_id}":{"get":{"tags":["IT"],"summary":"Company's Ubo","description":"This endpoint returns the company's ultimate beneficial owner.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"12485671007"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Ubo"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"presence":{"value":{"data":[{"name":"MARIO","surname":"ROSSI","taxCode":"MRORSS60U67H843Z","birthDate":"2025-11-25","birthTown":"ROMA","birthProvince":{"code":"RM","description":"Roma"},"address":{"toponym":"VIA","street":"VERDI","streetNumber":"666","zipCode":"00143","town":"ROMA","province":{"code":"RM","description":"Roma"},"region":{"code":"12","description":"Lazio"}},"roles":[{"code":"AMD","description":"PRESIDENTE CONSIGLIO AMMINISTRAZIONE","type":"CARICA"}]}],"success":true,"message":"","error":null}},"non-presence":{"value":{"data":[],"success":true,"message":"no ultimate beneficial owner found","error":null}}}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or vatCode required","error":1100,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1102,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"taxCode/vatCode/id not valid","error":1101,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1103,"data":null}}}}}}},"/FR-start/{siretCode_sirenCode_vatCode_or_id}":{"get":{"tags":["FR"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"siretCode_sirenCode_vatCode_or_id","in":"path","description":"Siren or Siret number, VAT number or company ID","required":true,"schema":{"type":"string","example":"851266429"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FrStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"siretCode":"85126642900014","companyName":"LES QUATRE HUB","tradingName":null,"aliasName":null,"sirenCode":"851266429","coCode":"FR80851266429","activityStatus":"ACTIVE","registrationDate":"2019-05-01","vatCode":"FR80851266429","address":{"registeredOffice":{"street":"Route du Pierrepont","streetNumber":"5","streetName":"5 ROUTE DU PIERREPONT","streetName2":null,"streetName3":null,"streetName4":"50550 SAINT-VAAST-LA-HOUGUE","town":"SAINT-VAAST-LA-HOUGUE","zipCode":"50550","country":"FR","gps":{"coordinates":[-1.26879,49.592236]},"townCode":"50562","department":{"code":"50","description":"Manche"},"region":{"code":"28","description":"Normandie"}}},"creationTimestamp":1730230336,"lastUpdateTimestamp":1724544000,"id":"67213840543743d927794c53"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, vatCode, siretCode or sirenCode required","error":800,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":802,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"sirenCode/siretCode/vatCode/id not valid","error":801,"data":null}}}}}}},"/FR-advanced/{siretCode_sirenCode_vatCode_or_id}":{"get":{"tags":["FR"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code, balance sheet and credit worthy.","parameters":[{"name":"siretCode_sirenCode_vatCode_or_id","in":"path","description":"Siren or Siret number, VAT number or company ID","required":true,"schema":{"type":"string","example":"851266429"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FrAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"siretCode":"53497325000010","companyName":"LE NOUVEAU SAINT MAX","tradingName":null,"aliasName":null,"sirenCode":"534973250","coCode":"FR54534973250","activityStatus":"ACTIVE","creditWorthy":1,"registrationDate":"2011-09-01","vatCode":"FR54534973250","address":{"registeredOffice":{"street":"Rue Louis Barthou","streetNumber":"35","streetName":"35 RUE LOUIS BARTHOU","streetName2":"NULL","streetName3":"NULL","streetName4":"54130 SAINT-MAX","town":"SAINT-MAX","zipCode":"54130","country":"FR","department":{"code":"54","description":"Meurthe-et-Moselle"},"gps":{"coordinates":[6.206291,48.698389]},"region":{"description":"Grand Est","code":"44"},"townCode":"54482"}},"internationalClassification":{"naf":{"code":"5610A","description":"Restauration traditionnelle"},"nace":{"code":"5610","description":"Restaurants and mobile food service activities"}},"detailedLegalForm":{"code":"SARL","description":null},"balanceSheets":{"last":{"year":2014,"balanceSheetDate":"2014-12-31","turnover":252900,"netWorth":13916,"employees":1},"all":[{"year":2014,"balanceSheetDate":"2014-12-31","turnover":252900,"netWorth":13916,"employees":1}]},"creationTimestamp":1725148800,"lastUpdateTimestamp":1760745600,"allOffices":[],"id":"672a26f4cc42ced63a092dec"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, vatCode, siretCode or sirenCode required","error":803,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":805,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"sirenCode/siretCode/vatCode/id not valid","error":804,"data":null}}}}}}},"/FR-search":{"get":{"tags":["FR"],"summary":"Advanced search and data","description":"With this endpoint we can draw up a list of companies that correspond to certain parameters described below. The call returns a maximum of 1000 results even if you set a higher limit.","parameters":[{"name":"dryRun","required":false,"in":"query","description":"simulates a request by returning only the number of records found and the price","schema":{"type":"integer","example":0,"enum":[1,0]}},{"name":"dataEnrichment","required":false,"in":"query","description":"with this parameter you can decide how to enrich the output data; if it is not set the call will return only the ids","schema":{"type":"string","example":"start","enum":["start","advanced"]}},{"name":"lat","required":false,"in":"query","description":"latitude","schema":{"type":"number","format":"double","minimum":-90,"maximum":90,"exclusiveMinimum":false,"exclusiveMaximum":false,"example":13.5478}},{"name":"long","required":false,"in":"query","description":"longitude","schema":{"type":"number","format":"double","minimum":-180,"maximum":180,"exclusiveMinimum":false,"exclusiveMaximum":false,"example":42.859}},{"name":"radius","required":false,"in":"query","description":"radius in meters","schema":{"type":"integer","minimum":0,"exclusiveMinimum":true,"example":100}},{"name":"companyName","required":false,"in":"query","description":"A search query; you can enter the company name (you can search for parts of the name as long as they are whole words) or alternatively '*' can be used as a wildcard to search for strings that start, contain or end with the given query. This search works with at least 3 characters.","schema":{"type":"string"},"examples":{"startsWith":{"value":"LES QUATRE*","summary":"Starts with"},"endsWith":{"value":"*QUATRE HUB","summary":"Ends with"},"contains":{"value":"QUATRE","summary":"Contains"}}},{"name":"autocomplete","required":false,"in":"query","description":"is used to search for strings that begin with the specified query","schema":{"type":"string","example":"les quat"}},{"name":"town","required":false,"in":"query","description":"the town for which you want to carry out the search","schema":{"type":"string","example":"paris"}},{"name":"townCode","required":false,"in":"query","description":"the town INSEE code for which you want to carry out the search","schema":{"type":"string","example":"42147"}},{"name":"nafCode","required":false,"in":"query","description":"naf code","schema":{"type":"string","example":"4779Z"}},{"name":"departmentCode","required":false,"in":"query","description":"the department INSEE code for which you want to carry out the search","schema":{"type":"string","example":"42"}},{"name":"regionCode","required":false,"in":"query","description":"the region INSEE code for which you want to carry out the search","schema":{"type":"string","example":"84"}},{"name":"minTurnover","required":false,"in":"query","description":"minimum turnover value","schema":{"type":"integer","example":100000}},{"name":"maxTurnover","required":false,"in":"query","description":"maximum turnover value","schema":{"type":"integer","example":1000000}},{"name":"minEmployees","required":false,"in":"query","description":"minimum value of employees","schema":{"type":"integer","example":1}},{"name":"maxEmployees","required":false,"in":"query","description":"maximum value of employees","schema":{"type":"integer","example":5}},{"name":"creditWorthy","required":false,"in":"query","description":"if the company is credit worthy, 0 - No, 1 – Yes","schema":{"type":"integer","example":1,"enum":[0,1]}},{"name":"legalFormCode","required":false,"in":"query","description":"legal form code","schema":{"type":"string","example":"SA et autes"}},{"name":"activityStatus","required":false,"in":"query","description":"status of the company","schema":{"type":"string","example":"ATTIVA","enum":["ACTIVE","CEASED"]}},{"name":"creationTimestamp","required":false,"in":"query","description":"all companies created after the value","schema":{"type":"integer","example":1624358855}},{"name":"lastUpdateTimestamp","required":false,"in":"query","description":"all companies whose last update is after the value","schema":{"type":"integer","example":1724399853}},{"name":"skip","required":false,"in":"query","description":"to set the number of records you want to skip from the result set","schema":{"type":"integer","example":50}},{"name":"limit","required":false,"in":"query","description":"number of results you want to receive; if not set, the call will return a maximum of 1000 results","schema":{"type":"integer","example":10,"minimum":1,"maximum":1000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/FrStart"},{"$ref":"#/components/schemas/FrAdvanced"},{"type":"object","properties":{"id":{"type":"string"}}}]}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"NoEnrichment":{"value":{"data":[{"id":"60d1bfc731177b0a092cdfc1"},{"id":"45d1bfc788174b9u092cdtr5"}],"success":true,"message":"","error":null}},"Start":{"value":{"data":[{"siretCode":"83889969800016","companyName":"COQUILLEAU CLAIRE","tradingName":null,"aliasName":null,"sirenCode":"838899698","coCode":"FR59838899698","activityStatus":"CEASED","registrationDate":"2018-04-01","vatCode":"FR59838899698","address":{"branchOffice":{"toponym":null,"street":"Rue de Paradis","streetNumber":"10","streetName":"10 RUE DE PARADIS","streetName2":null,"streetName3":null,"streetName4":"75010 PARIS","town":"PARIS","zipCode":"75010","country":"FR","gps":{"coordinates":[2.354329,48.874639]},"townCode":"75110","department":{"code":"75","description":"Paris"},"region":{"description":"Île-de-France","code":"11"}}},"creationTimestamp":1729809585,"lastUpdateTimestamp":1724544000,"id":"671accb162fc12c11e5b6490"},{"siretCode":"50347341500019","companyName":"FLUIDIAX","tradingName":"FLUIDIAX","aliasName":null,"sirenCode":"503473415","coCode":"FR83503473415","activityStatus":"ACTIVE","registrationDate":"2008-02-01","vatCode":"FR83503473415","address":{"registeredOffice":{"toponym":null,"street":"Boulevard de Magenta","streetNumber":"95","streetName":"95 BOULEVARD DE MAGENTA","streetName2":null,"streetName3":null,"streetName4":"75010 PARIS","town":"PARIS","zipCode":"75010","country":"FR","gps":{"coordinates":[2.354341,48.877921]},"townCode":"75110","department":{"code":"75","description":"Paris"},"region":{"description":"Île-de-France","code":"11"}}},"creationTimestamp":1729809585,"lastUpdateTimestamp":1724544000,"id":"671accb162fc12c11e5b649a"}],"success":true,"message":"","error":null}},"Advanced":{"value":{"data":[{"siretCode":"83772561300017","companyName":"FOENIX","tradingName":"MESO","aliasName":null,"sirenCode":"837725613","coCode":"FR68837725613","activityStatus":"CEASED","creditWorthy":0,"registrationDate":"2018-02-01","vatCode":"FR68837725613","address":{"branchOffice":{"toponym":null,"street":"Rue Papillon","streetNumber":"6","streetName":"6 RUE PAPILLON","streetName2":null,"streetName3":null,"streetName4":"75009 PARIS","town":"PARIS","zipCode":"75009","country":"FR","gps":{"coordinates":[2.347617,48.876077]},"townCode":"75109","department":{"code":"75","description":"Paris"},"region":{"description":"Île-de-France","code":"11"}}},"internationalClassification":{"naf":{"code":"5610A","description":"Restauration traditionnelle"},"nace":{"code":"5610","description":"Restaurants and mobile food service activities"}},"detailedLegalForm":{"code":"SA et autes","description":null},"balanceSheets":{"last":{"year":2019,"balanceSheetDate":"2019-12-31","turnover":967905,"netWorth":-293700,"employees":6},"all":[{"year":2019,"balanceSheetDate":"2019-12-31","turnover":967905,"netWorth":-293700,"employees":6}]},"creationTimestamp":1729734134,"lastUpdateTimestamp":1725494400,"id":"6719a5f662fc12c11e1dd90b","allOffices":[{"siretCode":"83772561300025","companyName":"FOENIX","address":{"registeredOffice":{"toponym":null,"street":"Rue Bleue","streetNumber":"2","streetName":"2 RUE BLEUE","streetName2":null,"streetName3":null,"streetName4":"75009 PARIS","town":"PARIS","zipCode":"75009","country":"FR","gps":{"coordinates":[2.347555,48.875879]},"townCode":"75109","department":{"code":"75","description":"Paris"},"region":{"description":"Île-de-France","code":"11"}}},"activityStatus":"ACTIVE"}]},{"siretCode":"39518070600016","companyName":"GANDON MARIE","tradingName":null,"aliasName":null,"sirenCode":"395180706","coCode":"FR79395180706","activityStatus":"CEASED","creditWorthy":0,"registrationDate":"1994-05-01","vatCode":"FR79395180706","address":{"registeredOffice":{"toponym":null,"street":"Rue du Mont Cenis","streetNumber":"80","streetName":"80 RUE DU MONT CENIS","streetName2":null,"streetName3":null,"streetName4":"75018 PARIS","town":"PARIS","zipCode":"75018","country":"FR","gps":{"coordinates":[2.345246,48.893914]},"townCode":"75118","department":{"code":"75","description":"Paris"},"region":{"description":"Île-de-France","code":"11"}}},"internationalClassification":{"naf":{"code":"5610A","description":"Restauration traditionnelle"},"nace":{"code":"5610","description":"Restaurants and mobile food service activities"}},"detailedLegalForm":{"code":null,"description":null},"balanceSheets":{"last":null,"all":[]},"creationTimestamp":1729734135,"lastUpdateTimestamp":1724544000,"id":"6719a5f762fc12c11e1dd921","allOffices":[]}],"success":true,"message":"","error":null}}}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"you have not passed any search parameters","error":807,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"departmentCode not valid","error":811,"data":null}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"example":{"success":false,"message":"invalid parameter, set 'lat' between -90 and 90","error":900,"data":null}}}}}}},"/DE-start/{vatCode_companyNumber_or_id}":{"get":{"tags":["DE"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_companyNumber_or_id","in":"path","description":"VAT number, company number or company ID","required":true,"schema":{"type":"string","example":"DE811115368"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DeStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67853ec6afaf0ee82618cca6","lastUpdateTimestamp":1736872416,"companyName":"AUDI Aktiengesellschaft","vatCode":"DE811115368","leiCode":"529900J1PXYSZJVZ3Z09","companyNumber":"HRB 1 (Ingolstadt)","address":{"registeredOffice":{"town":"Ingolstadt","country":"DE","zipCode":"85057","streetName":"Auto-Union-Str. 1","streetNumber":"1","gps":{"coordinates":[11.41527,48.7838]}}},"activityStatus":"ACTIVE","incorporationDate":"1873-01-01"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, companyNumber or european vatCode required","error":1000,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1001,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode or companyNumber not valid","error":2001,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1002,"data":null}}}}}}},"/DE-advanced/{vatCode_companyNumber_or_id}":{"get":{"tags":["DE"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_companyNumber_or_id","in":"path","description":"VAT number, company number or company ID","required":true,"schema":{"type":"string","example":"DE811115368"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DeAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67853ec6afaf0ee82618cca6","lastUpdateTimestamp":1736872416,"companyName":"AUDI Aktiengesellschaft","vatCode":"DE811115368","leiCode":"529900J1PXYSZJVZ3Z09","companyNumber":"HRB 1 (Ingolstadt)","address":{"registeredOffice":{"town":"Ingolstadt","country":"DE","zipCode":"85057","streetName":"Auto-Union-Str. 1","streetNumber":"1","gps":{"coordinates":[11.41527,48.7838]}}},"activityStatus":"ACTIVE","incorporationDate":"1873-01-01","contacts":{"fax":"+49 841 8932524","phone":"+49 841 89 0","website":"www.audi.de"},"internationalClassification":{"nace":{"code":"2920","description":"Manufacture of bodies (coachwork) for motor vehicles; manufacture of trailers and semi-trailers"},"naics":{"code":"336211","description":"Motor Vehicle Body Manufacturing"},"sic":{"code":"3711","description":"Motor Vehicles and Passenger Car Bodies"}},"balanceSheets":{"last":{"year":2023,"balanceSheetDate":"2023-12-31","employees":87736,"netWorth":6260000000,"operatingRevenue":69865000000,"equity":33839000000,"totalAssets":73447000000},"all":[{"year":2023,"balanceSheetDate":"2023-12-31","employees":87736,"netWorth":6260000000,"operatingRevenue":69865000000,"equity":33839000000,"totalAssets":73447000000},{"year":2022,"balanceSheetDate":"2022-12-31","employees":87996,"netWorth":7116000000,"operatingRevenue":63730000000,"equity":31582000000,"totalAssets":70812000000},{"year":2021,"balanceSheetDate":"2021-12-31","employees":85750,"netWorth":5649000000,"operatingRevenue":54993000000,"equity":26012000000,"totalAssets":66124000000},{"year":2020,"balanceSheetDate":"2020-12-31","employees":86860,"netWorth":3774000000,"operatingRevenue":50503000000,"equity":24253000000,"totalAssets":67229000000},{"year":2019,"balanceSheetDate":"2019-12-31","employees":90640,"netWorth":3850000000,"operatingRevenue":57663000000,"equity":28395000000,"totalAssets":66878000000}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, companyNumber or european vatCode required","error":1003,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1004,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode or companyNumber not valid","error":2001,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1005,"data":null}}}}}}},"/ES-start/{vatCode_taxCode_or_id}":{"get":{"tags":["ES"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"ESA95929659"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EsStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67936b12afaf0ee8261219eb","lastUpdateTimestamp":1736872416,"companyName":"Iberdrola Renovables Internacional Sociedad Anonima","taxCode":"A95929659","vatCode":"ESA95929659","leiCode":"959800R770F7R4JP6W69","address":{"registeredOffice":{"town":"Bilbao","country":"ES","zipCode":"48009","streetName":"Plaza Euskadi, 5 30 A 37","streetNumber":"5","gps":{"coordinates":[-2.93807,43.26751]}}},"activityStatus":"ACTIVE","incorporationDate":"2018-07-26"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or european vatCode required","error":1006,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1007,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode not valid, 9 chars required and the first or last must be a letter","error":2002,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1008,"data":null}}}}}}},"/ES-advanced/{vatCode_taxCode_or_id}":{"get":{"tags":["ES"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"ESA95929659"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EsAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67936b12afaf0ee8261219eb","lastUpdateTimestamp":1736872416,"companyName":"Iberdrola Renovables Internacional Sociedad Anonima","taxCode":"A95929659","vatCode":"ESA95929659","leiCode":"959800R770F7R4JP6W69","address":{"registeredOffice":{"town":"Bilbao","country":"ES","zipCode":"48009","streetName":"Plaza Euskadi, 5 30 A 37","streetNumber":"5","gps":{"coordinates":[-2.93807,43.26751]}}},"activityStatus":"ACTIVE","incorporationDate":"2018-07-26","contacts":{"fax":"","phone":"","website":"www.iberdrola.com"},"internationalClassification":{"nace":{"code":"8211","description":"Combined office administrative service activities"},"naics":{"code":"561110","description":"Office Administrative Services"},"sic":{"code":"8741","description":"Management Services"}},"balanceSheets":{"last":{"year":2023,"balanceSheetDate":"2023-12-31","employees":112,"netWorth":525869000,"operatingRevenue":319531000,"equity":2167965000,"totalAssets":2480358000},"all":[{"year":2023,"balanceSheetDate":"2023-12-31","employees":112,"netWorth":525869000,"operatingRevenue":319531000,"equity":2167965000,"totalAssets":2480358000},{"year":2022,"balanceSheetDate":"2022-12-31","employees":638,"netWorth":129328000,"operatingRevenue":826995000,"equity":3407783000,"totalAssets":7808710000},{"year":2021,"balanceSheetDate":"2021-12-31","employees":520,"netWorth":119669000,"operatingRevenue":574766000,"equity":2190893000,"totalAssets":6023605000},{"year":2020,"balanceSheetDate":"2020-12-31","employees":383,"netWorth":127421000,"operatingRevenue":467519000,"equity":1156494000,"totalAssets":4634422000},{"year":2019,"balanceSheetDate":"2019-12-31","employees":225,"netWorth":155518000,"operatingRevenue":405970000,"equity":1184784000,"totalAssets":2755747000},{"year":2018,"balanceSheetDate":"2018-12-31","employees":null,"netWorth":48536361,"operatingRevenue":46809568,"equity":975606720,"totalAssets":989886020}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or european vatCode required","error":1009,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1010,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode not valid, 9 chars required and the first or last must be a letter","error":2002,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1011,"data":null}}}}}}},"/PT-start/{vatCode_taxCode_or_id}":{"get":{"tags":["PT"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"PT500273170"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PtStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"679a384b44a1598472a584dc","lastUpdateTimestamp":1736872416,"companyName":"Sonae, Sgps, S A","taxCode":"500273170","vatCode":"PT500273170","leiCode":"549300847SOBT7HY7R50","address":{"registeredOffice":{"town":"Maia","country":"PT","zipCode":"4470-177","streetName":"Rua Do Espido, Via Norte","streetNumber":null,"gps":{"coordinates":[-8.63941,41.23343]}}},"activityStatus":"ACTIVE","incorporationDate":"1959-05-18"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or european vatCode required","error":1012,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1013,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode not valid, only 9 numbers required","error":2004,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1014,"data":null}}}}}}},"/PT-advanced/{vatCode_taxCode_or_id}":{"get":{"tags":["PT"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"PT500273170"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PtAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"679a27b6269da526fedb81f5","lastUpdateTimestamp":1738076833,"companyName":"Sonae, Sgps, S A ","taxCode":"500273170","vatCode":"PT500273170","leiCode":"549300847SOBT7HY7R50","address":{"registeredOffice":{"town":"Maia","country":"PT","zipCode":"4470-177","streetName":"Rua Do Espido, Via Norte","streetNumber":null,"gps":{"coordinates":[-8.63941,41.23343]}}},"activityStatus":"ACTIVE","incorporationDate":"1959-05-18","contacts":{"fax":"","phone":"+351 220104000","website":"www.sonae.pt"},"internationalClassification":{"nace":{"code":"4719","description":"Other retail sale in non-specialised stores"},"naics":{"code":"455110","description":"Department Stores"},"sic":{"code":"5311","description":"Department Stores"}},"balanceSheets":{"last":{"year":2023,"balanceSheetDate":"2023-12-31","employees":null,"netWorth":357062000,"operatingRevenue":8622604000,"equity":3461779000,"totalAssets":8845055000},"all":[{"year":2023,"balanceSheetDate":"2023-12-31","employees":null,"netWorth":357062000,"operatingRevenue":8622604000,"equity":3461779000,"totalAssets":8845055000},{"year":2022,"balanceSheetDate":"2022-12-31","employees":48222,"netWorth":406655000,"operatingRevenue":8047340000,"equity":3320400000,"totalAssets":8647091000},{"year":2021,"balanceSheetDate":"2021-12-31","employees":null,"netWorth":267653000,"operatingRevenue":7274581000,"equity":3145394000,"totalAssets":8317113000},{"year":2020,"balanceSheetDate":"2020-12-31","employees":44409,"netWorth":55659157,"operatingRevenue":7051492426,"equity":2439852346,"totalAssets":8148927271}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode or european vatCode required","error":1015,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1016,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode not valid, only 9 numbers required","error":2004,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1017,"data":null}}}}}}},"/GB-start/{vatCode_companyNumber_or_id}":{"get":{"tags":["GB"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_companyNumber_or_id","in":"path","description":"VAT number, company number or company ID","required":true,"schema":{"type":"string","example":"GB226312538"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GbStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67a4d542d3a596ef9ffbccbd","lastUpdateTimestamp":1736872416,"companyName":"Mcloud Limited","companyNumber":"08784085","vatCode":"GB226312538","address":{"registeredOffice":{"town":"London","country":"GB","zipCode":"W1B 2LE","streetName":"Suite 21 4 Princes Street Mayfair","streetNumber":"4","gps":{"coordinates":[-0.14269,51.51466]}}},"activityStatus":"ACTIVE","incorporationDate":"2013-11-20"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, companyNumber or european vatCode required","error":1018,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1019,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode or companyNumber not valid","error":2003,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1020,"data":null}}}}}}},"/GB-advanced/{vatCode_companyNumber_or_id}":{"get":{"tags":["GB"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_companyNumber_or_id","in":"path","description":"VAT number, company number or company ID","required":true,"schema":{"type":"string","example":"GB226312538"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GbAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67a4d542d3a596ef9ffbccbd","lastUpdateTimestamp":1738943270,"companyName":"Mcloud Limited","companyNumber":"08784085","vatCode":"GB226312538","address":{"registeredOffice":{"town":"London","country":"GB","zipCode":"W1B 2LE","streetName":"Suite 21 4 Princes Street Mayfair","streetNumber":"4","gps":{"coordinates":[-0.14269,51.51466]}}},"activityStatus":"ACTIVE","incorporationDate":"2013-11-20","contacts":{"fax":"","phone":"+44 20 3300 0789","website":"www.mcloudltd.com"},"internationalClassification":{"nace":{"code":"8299","description":"Other business support service activities n.e.c."},"naics":{"code":"561499","description":"All Other Business Support Services"},"sic":{"code":"7389","description":"Business Services, Not Elsewhere Classified"}},"balanceSheets":{"last":{"year":2022,"balanceSheetDate":"2022-11-30","employees":2,"netWorth":null,"operatingRevenue":null,"equity":301,"totalAssets":23628},"all":[{"year":2022,"balanceSheetDate":"2022-11-30","employees":2,"netWorth":null,"operatingRevenue":null,"equity":301,"totalAssets":23628},{"year":2021,"balanceSheetDate":"2021-11-30","employees":2,"netWorth":null,"operatingRevenue":null,"equity":2449,"totalAssets":45071},{"year":2020,"balanceSheetDate":"2020-11-30","employees":2,"netWorth":41932,"operatingRevenue":276062,"equity":2123,"totalAssets":47143},{"year":2019,"balanceSheetDate":"2019-11-30","employees":1,"netWorth":33445,"operatingRevenue":130604,"equity":22643,"totalAssets":64299},{"year":2018,"balanceSheetDate":"2018-11-30","employees":1,"netWorth":998,"operatingRevenue":72211,"equity":12123,"totalAssets":23478},{"year":2017,"balanceSheetDate":"2017-11-30","employees":1,"netWorth":null,"operatingRevenue":null,"equity":15780,"totalAssets":37909},{"year":2016,"balanceSheetDate":"2016-11-30","employees":null,"netWorth":null,"operatingRevenue":null,"equity":6869,"totalAssets":15701},{"year":2015,"balanceSheetDate":"2015-11-30","employees":null,"netWorth":null,"operatingRevenue":null,"equity":3773,"totalAssets":11111}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, companyNumber or european vatCode required","error":1021,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1022,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode or companyNumber not valid","error":2003,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1023,"data":null}}}}}}},"/WW-start/{country}/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["WW"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"country","in":"path","description":"ISO code of the country","required":true,"schema":{"type":"string","example":"PL"}},{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code, company number or company ID","required":true,"schema":{"type":"string","example":6462441581}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/Start"},{"$ref":"#/components/schemas/FrStart"},{"$ref":"#/components/schemas/DeStart"},{"$ref":"#/components/schemas/EsStart"},{"$ref":"#/components/schemas/PtStart"},{"$ref":"#/components/schemas/GbStart"},{"$ref":"#/components/schemas/BeStart"},{"$ref":"#/components/schemas/AtStart"},{"$ref":"#/components/schemas/ChStart"},{"$ref":"#/components/schemas/PlStart"},{"$ref":"#/components/schemas/WwStart"}]}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67b368a61b7001981c6013ec","lastUpdateTimestamp":1739810982,"companyName":"Wilk Elektronik S.A.","companyNumber":"0000068827","regonNumber":"276675936","taxCode":"6462441581","leiCode":"259400MOV1C1EUJWWC81","vatCode":"PL6462441581","address":{"registeredOffice":{"town":"Laziska Gorne","country":"PL","zipCode":"43-173","streetName":"Mikolowska 42","streetNumber":"42","gps":{"coordinates":[18.88217,50.15951]}}},"activityStatus":"ACTIVE","incorporationDate":"1999-01-01"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"country required","error":1025,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1026,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode, regonNumber or companyNumber not valid. Note: Only the 9-digit main entity REGON is accepted","error":2005,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1027,"data":null}}}}}}},"/WW-advanced/{country}/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["WW"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"country","in":"path","description":"ISO code of the country","required":true,"schema":{"type":"string","example":"PL"}},{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code, company number or company ID","required":true,"schema":{"type":"string","example":6462441581}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/Advanced"},{"$ref":"#/components/schemas/FrAdvanced"},{"$ref":"#/components/schemas/DeAdvanced"},{"$ref":"#/components/schemas/EsAdvanced"},{"$ref":"#/components/schemas/PtAdvanced"},{"$ref":"#/components/schemas/GbAdvanced"},{"$ref":"#/components/schemas/BeAdvanced"},{"$ref":"#/components/schemas/AtAdvanced"},{"$ref":"#/components/schemas/ChAdvanced"},{"$ref":"#/components/schemas/PlAdvanced"},{"$ref":"#/components/schemas/WwAdvanced"}]}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67b368a61b7001981c6013ec","lastUpdateTimestamp":1739810982,"companyName":"Wilk Elektronik S.A.","companyNumber":"0000068827","regonNumber":"276675936","taxCode":"6462441581","leiCode":"259400MOV1C1EUJWWC81","vatCode":"PL6462441581","address":{"registeredOffice":{"town":"Laziska Gorne","country":"PL","zipCode":"43-173","streetName":"Mikolowska 42","streetNumber":"42","gps":{"coordinates":[18.88217,50.15951]}}},"activityStatus":"ACTIVE","incorporationDate":"1999-01-01","contacts":{"fax":"+48 32 7369001","phone":"+48 32 7369000","website":"www.goodram.com"},"internationalClassification":{"nace":{"code":"2620","description":"Manufacture of computers and peripheral equipment"},"naics":{"code":"334112","description":"Computer Storage Device Manufacturing"},"sic":{"code":"3572","description":"Computer Storage Devices"}},"balanceSheets":{"last":{"year":2023,"balanceSheetDate":"2023-03-31","employees":189,"netWorth":-2497069,"operatingRevenue":81133443,"equity":1446754,"totalAssets":15952416},"all":[{"year":2023,"balanceSheetDate":"2023-03-31","employees":189,"netWorth":-2497069,"operatingRevenue":81133443,"equity":1446754,"totalAssets":15952416},{"year":2022,"balanceSheetDate":"2022-03-31","employees":193,"netWorth":6647160,"operatingRevenue":153361153,"equity":10614552,"totalAssets":30916351},{"year":2020,"balanceSheetDate":"2020-12-31","employees":164,"netWorth":4129074,"operatingRevenue":116439536,"equity":8120245,"totalAssets":29172168},{"year":2019,"balanceSheetDate":"2019-12-31","employees":172,"netWorth":2177747,"operatingRevenue":102524512,"equity":6491988,"totalAssets":22689728},{"year":2018,"balanceSheetDate":"2018-12-31","employees":165,"netWorth":-71779,"operatingRevenue":176205085,"equity":4275634,"totalAssets":20584880},{"year":2017,"balanceSheetDate":"2017-12-31","employees":177,"netWorth":5742827,"operatingRevenue":170787129,"equity":10225092,"totalAssets":37106226},{"year":2016,"balanceSheetDate":"2016-12-31","employees":null,"netWorth":4545559,"operatingRevenue":100357099,"equity":8788082,"totalAssets":31344725},{"year":2015,"balanceSheetDate":"2015-12-31","employees":null,"netWorth":1922241,"operatingRevenue":81959638,"equity":6322627,"totalAssets":16620647}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"country required","error":1028,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1030,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode, regonNumber or companyNumber not valid. Note: Only the 9-digit main entity REGON is accepted","error":2005,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1031,"data":null}}}}}}},"/WW-top/{country}/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["WW"],"summary":"Top data","description":"This endpoint gets top information about a company such as company size, international and national code, nomenclature of territorial units for statistics and balance sheet.","parameters":[{"name":"country","in":"path","description":"ISO code of the country","required":true,"schema":{"type":"string","example":"LT"}},{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code, company number or company ID","required":true,"schema":{"type":"string","example":"LT100003695519"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WwTop"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67c6c4721b7001981c9666a2","lastUpdateTimestamp":1741079665,"companyName":"UAB Contentus","nativeCompanyName":"UAB Contentus","companySize":"Medium sized company","vatCode":"LT100003695519","markers":[{"label":"Trade register number","number":"300556523","types":["Trade register number"]},{"label":"VAT number, European VAT number","number":"LT100003695519","types":["VAT/Tax number","European VAT number"]}],"address":{"registeredOffice":{"town":"Vilniaus M.","country":"LT","zipCode":"02103","streetName":"Varsuvos G. 11-3","streetNumber":"11","gps":{"coordinates":[25.29749,54.67029]},"nativeTown":"Vilniaus M.","county":"Eastern Europe","nuts1":"LT0 - Lithuania","nuts2":"LT01 - Capital Region","nuts3":"LT011 - Vilnius","usMetropolitanArea":"","usState":"","locationArea":[{"type":"County","description":"Vilnius"},{"type":"City municipality","description":"Vilniaus M. Sav."}]}},"activityStatus":"ACTIVE","incorporationDate":"2006-04-03","contacts":{"fax":"+370 5 2108773","phone":"+370 5 2772184","website":"www.contentus.lt"},"internationalClassification":{"nace":{"primary":[{"code":"4669","description":"Wholesale of other machinery and equipment","core":"Wholesale","section":"G - Wholesale and retail trade; repair of motor vehicles and motorcycles","division":"46 - Wholesale trade, except of motor vehicles and motorcycles","group":"466 - Wholesale of other machinery, equipment and supplies"}],"secondary":[{"code":"4778","description":"Other retail sale of new goods in specialised stores","core":"Wholesale","section":"G - Wholesale and retail trade; repair of motor vehicles and motorcycles","division":"47 - Retail trade, except of motor vehicles and motorcycles","group":"477 - Retail sale of other goods in specialised stores"},{"code":"7112","description":"Engineering activities and related technical consultancy","core":"Wholesale","section":"M - Professional, scientific and technical activities","division":"71 - Architectural and engineering activities; technical testing and analysis","group":"711 - Architectural and engineering activities and related technical consultancy"}]},"naics":{"primary":[{"code":"423830","description":"Industrial Machinery and Equipment Merchant Wholesalers","section":"42 - Wholesale Trade","division":"423 - Merchant Wholesalers, Durable Goods","group":"4238 - Machinery, Equipment, and Supplies Merchant Wholesalers"}],"secondary":[{"code":"459999","description":"All Other Miscellaneous Retailers","section":"45 - Retail Trade","division":"459 - Sporting Goods, Hobby, Musical Instrument, Book, and Miscellaneous Retailers","group":"4599 - Other Miscellaneous Retailers"},{"code":"541330","description":"Engineering Services","section":"54 - Professional, Scientific, and Technical Services","division":"541 - Professional, Scientific, and Technical Services","group":"5413 - Architectural, Engineering, and Related Services"}]},"sic":{"primary":[{"code":"5084","description":"Industrial Machinery and Equipment","section":"F - Wholesale Trade","division":"50 - Wholesale Trade-durable Goods","group":"508 - Machinery, Equipment, And Supplies"}],"secondary":[{"code":"5999","description":"Miscellaneous Retail Stores, Not Elsewhere Classified","section":"G - Retail Trade","division":"59 - Miscellaneous Retail","group":"599 - Retail Stores, Not Elsewhere Classified"},{"code":"8711","description":"Engineering Services","section":"I - Services","division":"87 - Engineering, Accounting, Research, Management, And Related Services","group":"871 - Engineering, Architectural, And Surveying"}]}},"nationalClassification":{"type":["NACE Rev. 2"],"primary":["4669"],"secondary":["4778","7112"]},"balanceSheets":{"last":{"year":2022,"balanceSheetDate":"2022-12-31","employees":5,"netWorth":401837,"operatingRevenue":5113928,"equity":405055,"totalAssets":1039542},"all":[{"year":2022,"balanceSheetDate":"2022-12-31","employees":5,"netWorth":401837,"operatingRevenue":5113928,"equity":405055,"totalAssets":1039542},{"year":2021,"balanceSheetDate":"2021-12-31","employees":4,"netWorth":99875,"operatingRevenue":1859980,"equity":123394,"totalAssets":344125},{"year":2020,"balanceSheetDate":"2020-12-31","employees":4,"netWorth":59606,"operatingRevenue":1719231,"equity":64912,"totalAssets":171176},{"year":2019,"balanceSheetDate":"2019-12-31","employees":5,"netWorth":1752,"operatingRevenue":2233241,"equity":75894,"totalAssets":387517},{"year":2018,"balanceSheetDate":"2018-12-31","employees":4,"netWorth":11009,"operatingRevenue":1217514,"equity":73504,"totalAssets":113279},{"year":2017,"balanceSheetDate":"2017-12-31","employees":3,"netWorth":4417,"operatingRevenue":1021865,"equity":62743,"totalAssets":111425},{"year":2016,"balanceSheetDate":"2016-12-31","employees":3,"netWorth":28877,"operatingRevenue":938167,"equity":58325,"totalAssets":73581},{"year":2015,"balanceSheetDate":"2015-12-31","employees":2,"netWorth":null,"operatingRevenue":475000,"equity":null,"totalAssets":null}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"country required","error":1032,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1034,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"the country's ISO code does not exist","error":2000,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1035,"data":null}}}}}}},"/BE-start/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["BE"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"BE0836159992"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BeStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"68356fff2e1d3b182a7371eb","lastUpdateTimestamp":1748332542,"companyName":"Showpad","companyNumber":"0836.159.992","establishmentNumber":"2.199.301.190","vatCode":"BE0836159992","leiCode":"894500UYRN65RZIXSF11","taxCode":"0836159992","address":{"registeredOffice":{"town":"Gent","country":"BE","zipCode":9000,"streetName":"Moutstraat 62","streetNumber":null,"gps":{"coordinates":[51.03008581989424,3.7376599254086043]}}},"activityStatus":"ACTIVE","incorporationDate":"2011-05-05"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode, companyNumber or european vatCode required","error":1036,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1037,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode or companyNumber not valid","error":2007,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1038,"data":null}}}}}}},"/BE-advanced/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["BE"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"BE0836159992"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BeAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"68356fff2e1d3b182a7371eb","lastUpdateTimestamp":1748332542,"companyName":"Showpad","companyNumber":"0836.159.992","establishmentNumber":"2.199.301.190","vatCode":"BE0836159992","leiCode":"894500UYRN65RZIXSF11","taxCode":"0836159992","address":{"registeredOffice":{"town":"Gent","country":"BE","zipCode":9000,"streetName":"Moutstraat 62","streetNumber":null,"gps":{"coordinates":[51.03008581989424,3.7376599254086043]}}},"activityStatus":"ACTIVE","incorporationDate":"2011-05-05","contacts":{"fax":"","phone":"+32 9 395 02 33","website":"www.showpad.com"},"internationalClassification":{"nace":{"code":"6201","description":"Computer programming activities"},"naics":{"code":"541511","description":"Custom Computer Programming Services"},"sic":{"code":"7371","description":"Computer Programming Services"}},"balanceSheets":{"last":{"year":2024,"balanceSheetDate":"2024-01-31","employees":413,"netWorth":-11433000,"operatingRevenue":98046000,"equity":-38474000,"totalAssets":65631000},"all":[{"year":2024,"balanceSheetDate":"2024-01-31","employees":413,"netWorth":-11433000,"operatingRevenue":98046000,"equity":-38474000,"totalAssets":65631000},{"year":2023,"balanceSheetDate":"2023-01-31","employees":474,"netWorth":-29347000,"operatingRevenue":96708000,"equity":-27314000,"totalAssets":69330000},{"year":2022,"balanceSheetDate":"2022-01-31","employees":165,"netWorth":4729000,"operatingRevenue":54701759,"equity":95147389,"totalAssets":135523703},{"year":2021,"balanceSheetDate":"2021-01-31","employees":150,"netWorth":-6882464,"operatingRevenue":48098554,"equity":89282921,"totalAssets":129014699},{"year":2020,"balanceSheetDate":"2020-01-31","employees":148,"netWorth":-11553054,"operatingRevenue":39323897,"equity":96118643,"totalAssets":120270198},{"year":2019,"balanceSheetDate":"2019-01-31","employees":125,"netWorth":-5440346,"operatingRevenue":25306735,"equity":64895314,"totalAssets":86308052},{"year":2018,"balanceSheetDate":"2018-01-31","employees":108,"netWorth":-12141555,"operatingRevenue":17412216,"equity":37491788,"totalAssets":52268959},{"year":2016,"balanceSheetDate":"2016-12-31","employees":74,"netWorth":-6430882,"operatingRevenue":10019285,"equity":29392342,"totalAssets":37306246}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode, companyNumber or european vatCode required","error":1039,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1040,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode or companyNumber not valid","error":2007,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1041,"data":null}}}}}}},"/AT-start/{vatCode_companyNumber_or_id}":{"get":{"tags":["AT"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_companyNumber_or_id","in":"path","description":"VAT number or company ID","required":true,"schema":{"type":"string","example":"ATU22852606"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AtStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"682f26c42e1d3b182ae65202","lastUpdateTimestamp":1747920580,"companyName":"Oberbank AG","vatCode":"ATU22852606","leiCode":"RRUN0TCQ1K2JDV7MXO75","companyNumber":"FN 79063 w (Linz)","address":{"registeredOffice":{"town":"Linz","country":"AT","zipCode":4020,"streetName":"Untere Donaulaende 28","streetNumber":null,"gps":{"coordinates":[51.03008581989424,3.7376599254086043]}}},"activityStatus":"ACTIVE","incorporationDate":"1869-07-04"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, companyNumber or european vatCode required","error":1048,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1049,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode or companyNumber not valid","error":2008,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1050,"data":null}}}}}}},"/AT-advanced/{vatCode_companyNumber_or_id}":{"get":{"tags":["AT"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_companyNumber_or_id","in":"path","description":"VAT number or company ID","required":true,"schema":{"type":"string","example":"ATU22852606"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AtAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"682f26c42e1d3b182ae65202","lastUpdateTimestamp":1747920580,"companyName":"Oberbank AG","vatCode":"ATU22852606","leiCode":"RRUN0TCQ1K2JDV7MXO75","companyNumber":"FN 79063 w (Linz)","address":{"registeredOffice":{"town":"Linz","country":"AT","zipCode":4020,"streetName":"Untere Donaulaende 28","streetNumber":null,"gps":{"coordinates":[51.03008581989424,3.7376599254086043]}}},"activityStatus":"ACTIVE","incorporationDate":"1869-07-04","contacts":{"fax":"+43 732 7802 32140","phone":"+43 732 7802 0","website":"www.oberbank.at"},"internationalClassification":{"nace":{"code":"6419","description":"Other monetary intermediation"},"naics":{"code":"522110","description":"Commercial Banking"},"sic":{"code":"6021","description":"National Commercial Banks"}},"balanceSheets":{"last":{"year":2024,"balanceSheetDate":"2024-01-01","employees":2074,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},"all":[{"year":2024,"balanceSheetDate":"2024-01-01","employees":2074,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2023,"balanceSheetDate":"2023-12-31","employees":2461,"netWorth":382603000,"operatingRevenue":973166000,"equity":3863073000,"totalAssets":27834471000},{"year":2022,"balanceSheetDate":"2022-12-31","employees":2139,"netWorth":243287000,"operatingRevenue":706652000,"equity":3546920000,"totalAssets":26798166000},{"year":2021,"balanceSheetDate":"2021-12-31","employees":2158,"netWorth":234648000,"operatingRevenue":687548000,"equity":3317861000,"totalAssets":27539663000}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"id, companyNumber or european vatCode required","error":1051,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1052,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode or companyNumber not valid","error":2008,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1053,"data":null}}}}}}},"/CH-start/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["CH"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"CHE-108.167.035"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"682df39e2e1d3b182acb61d6","lastUpdateTimestamp":1748964807,"companyName":"CPM Switzerland AG","companyNumber":"CH-020.3.918.069-0","vatCode":"CHE-108.167.035","taxCode":"108167035","leiCode":"2138007F3RA1YRID9S87","address":{"registeredOffice":{"town":"Thalwil","country":"CH","zipCode":"8800","streetName":"Seestrasse 97","streetNumber":"97","gps":{"coordinates":[8.57057,47.29279]}}},"activityStatus":"ACTIVE","incorporationDate":"1983-11-04"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode, companyNumber or vatCode required","error":1054,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1055,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode or companyNumber not valid","error":2009,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1056,"data":null}}}}}}},"/CH-advanced/{vatCode_companyNumber_taxCode_or_id}":{"get":{"tags":["CH"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_companyNumber_taxCode_or_id","in":"path","description":"VAT number, tax code or company ID","required":true,"schema":{"type":"string","example":"CHE-108.167.035"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"682df39e2e1d3b182acb61d6","lastUpdateTimestamp":1748964807,"companyName":"CPM Switzerland AG","companyNumber":"CH-020.3.918.069-0","vatCode":"CHE-108.167.035","taxCode":"108167035","leiCode":"2138007F3RA1YRID9S87","address":{"registeredOffice":{"town":"Thalwil","country":"CH","zipCode":"8800","streetName":"Seestrasse 97","streetNumber":"97","gps":{"coordinates":[8.57057,47.29279]}}},"activityStatus":"ACTIVE","incorporationDate":"1983-11-04","contacts":{"fax":"+41 43 3222060","phone":"+41 43 3222050","website":"www.ch.cpm-int.com"},"internationalClassification":{"nace":{"code":"7311","description":"Advertising agencies"},"naics":{"code":"541810","description":"Advertising Agencies"},"sic":{"code":"7311","description":"Advertising Agencies"}},"balanceSheets":{"last":{"year":2024,"balanceSheetDate":"2024-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},"all":[{"year":2024,"balanceSheetDate":"2024-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2023,"balanceSheetDate":"2023-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2022,"balanceSheetDate":"2022-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2021,"balanceSheetDate":"2021-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2020,"balanceSheetDate":"2020-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2019,"balanceSheetDate":"2019-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2018,"balanceSheetDate":"2018-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2017,"balanceSheetDate":"2017-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2016,"balanceSheetDate":"2016-01-01","employees":75,"netWorth":null,"operatingRevenue":null,"equity":null,"totalAssets":null},{"year":2015,"balanceSheetDate":"2015-01-01","employees":75,"netWorth":null,"operatingRevenue":1379503,"equity":null,"totalAssets":null}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode, companyNumber or vatCode required","error":1057,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1058,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode or companyNumber not valid","error":2009,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1059,"data":null}}}}}}},"/PL-start/{vatCode_companyNumber_taxCode_regonNumber_or_id}":{"get":{"tags":["PL"],"summary":"Basic data","description":"This enpoint returns basic information of a company such as company name and address.","parameters":[{"name":"vatCode_companyNumber_taxCode_regonNumber_or_id","in":"path","description":"VAT number, tax code, regon number or company ID. Note: Only the 9-digit main entity REGON is accepted.","required":true,"schema":{"type":"string","example":"PL6462441581"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlStart"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67ab80e7d3a596ef9fa5dd60","lastUpdateTimestamp":1748952835,"companyName":"Wilk Elektronik S.A.","companyNumber":"0000068827","regonNumber":"276675936","taxCode":"6462441581","leiCode":"259400MOV1C1EUJWWC81","vatCode":"PL6462441581","address":{"registeredOffice":{"town":"Laziska Gorne","country":"PL","zipCode":"43-173","streetName":"Mikolowska 42","streetNumber":"42","gps":{"coordinates":[18.88217,50.15951]}}},"activityStatus":"ACTIVE","incorporationDate":"1999-01-01"}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode, companyNumber, regonNumber or european vatCode required","error":1042,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1043,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode, regonNumber or companyNumber not valid. Note: Only the 9-digit main entity REGON is accepted","error":2005,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1044,"data":null}}}}}}},"/PL-advanced/{vatCode_companyNumber_taxCode_regonNumber_or_id}":{"get":{"tags":["PL"],"summary":"Advanced data","description":"This endpoint gets advanced information about a company such as international code and balance sheet.","parameters":[{"name":"vatCode_companyNumber_taxCode_regonNumber_or_id","in":"path","description":"VAT number, tax code, regon number or company ID. Note: Only the 9-digit main entity REGON is accepted.","required":true,"schema":{"type":"string","example":"PL6462441581"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlAdvanced"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"67ab80e7d3a596ef9fa5dd60","lastUpdateTimestamp":1748952835,"companyName":"Wilk Elektronik S.A.","companyNumber":"0000068827","regonNumber":"276675936","taxCode":"6462441581","leiCode":"259400MOV1C1EUJWWC81","vatCode":"PL6462441581","address":{"registeredOffice":{"town":"Laziska Gorne","country":"PL","zipCode":"43-173","streetName":"Mikolowska 42","streetNumber":"42","gps":{"coordinates":[18.88217,50.15951]}}},"activityStatus":"ACTIVE","incorporationDate":"1999-01-01","contacts":{"fax":"+48 32 7369001","phone":"+48 32 7369000","website":"www.goodram.com"},"internationalClassification":{"nace":{"code":"2620","description":"Manufacture of computers and peripheral equipment"},"naics":{"code":"334112","description":"Computer Storage Device Manufacturing"},"sic":{"code":"3572","description":"Computer Storage Devices"}},"balanceSheets":{"last":{"year":2023,"balanceSheetDate":"2023-03-31","employees":189,"netWorth":-2497069,"operatingRevenue":81133443,"equity":1446754,"totalAssets":15952416},"all":[{"year":2023,"balanceSheetDate":"2023-03-31","employees":189,"netWorth":-2497069,"operatingRevenue":81133443,"equity":1446754,"totalAssets":15952416},{"year":2022,"balanceSheetDate":"2022-03-31","employees":193,"netWorth":6647160,"operatingRevenue":153361153,"equity":10614552,"totalAssets":30916351},{"year":2020,"balanceSheetDate":"2020-12-31","employees":164,"netWorth":4129074,"operatingRevenue":116439536,"equity":8120245,"totalAssets":29172168},{"year":2019,"balanceSheetDate":"2019-12-31","employees":172,"netWorth":2177747,"operatingRevenue":102524512,"equity":6491988,"totalAssets":22689728},{"year":2018,"balanceSheetDate":"2018-12-31","employees":165,"netWorth":-71779,"operatingRevenue":176205085,"equity":4275634,"totalAssets":20584880},{"year":2017,"balanceSheetDate":"2017-12-31","employees":177,"netWorth":5742827,"operatingRevenue":170787129,"equity":10225092,"totalAssets":37106226},{"year":2016,"balanceSheetDate":"2016-12-31","employees":null,"netWorth":4545559,"operatingRevenue":100357099,"equity":8788082,"totalAssets":31344725},{"year":2015,"balanceSheetDate":"2015-12-31","employees":null,"netWorth":1922241,"operatingRevenue":81959638,"equity":6322627,"totalAssets":16620647}]}}],"success":true,"message":"","error":null}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Id, taxCode, companyNumber, regonNumber or european vatCode required","error":1045,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no company matches this id: ","error":1046,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"vatCode, taxCode, regonNumber or companyNumber not valid. Note: Only the 9-digit main entity REGON is accepted","error":2005,"data":null}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service not available at the moment","error":1047,"data":null}}}}}}},"/monitor":{"get":{"tags":["Monitor"],"summary":"List of all requests","description":"Summary list of all requests made from your profile","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MonitorRequests"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"companyName":"OPENAPI S.P.A.","checkedOn":"2026-01-31T00:00:00.000Z","nextOn":"2026-03-02T00:00:00.000Z","expiresOn":"2027-01-30T00:00:00.000Z","id":"5f22f722065afc42223c7131"},{"companyName":"RED FLAG SRL","checkedOn":"2026-01-31T00:00:00.000Z","nextOn":"2026-03-02T00:00:00.000Z","expiresOn":"2027-01-30T00:00:00.000Z","id":"697ce19f5610b4a8910670c4"}],"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no monitoring requests related to your account","error":1200,"data":null}}}}}},"post":{"tags":["Monitor"],"summary":"New monitor request","description":"With this endpoint you can create a new monitoring request on a company","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorPayload"},"example":{"code":"12485671007","dataset":"IT-advanced","monitoredFields":["activityStatus"],"callback":{"url":"https://webhook.site/f24cec85-22e3-4f7c-8ec0-227b240daa42"}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MonitorRequest"}}}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MonitorRequest"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"code":"12485671007","dataset":"IT-advanced","monitoredFields":["pec"],"callback":{"method":"JSON","url":"https://webhook.site/28a4dddf-eca1-47f2-88d8-94878995e4d8","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"owner":"gcloud-tests@openapi.it","createdOn":"2026-02-03","companyId":"60d1bfc731177b0a092cdfc1","vatCode":"12485671007","taxCode":"12485671007","companyName":"OPENAPI S.P.A.","updatedFields":null,"latestDataset":null,"previousDataset":null,"checkedOn":null,"nextOn":"2026-03-05","expiresOn":"2027-02-03","autorenew":true,"id":"6981e3571a222556460af532"},"success":true,"message":"","error":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":610,"data":null}}}},"404":{"description":"Not Found","content":{"application/json":{"examples":{"1207":{"value":{"success":false,"message":"dataset not found","error":1207,"data":null}},"1211":{"value":{"success":false,"message":"no company matches this id: 697ce19f5610b4a8910670c4","error":1211,"data":null}},"1212":{"value":{"success":false,"message":"no company found","error":1212,"data":null}},"1213":{"value":{"success":false,"message":"no company found","error":1213,"data":null}},"1214":{"value":{"success":false,"message":"no company found (may not be registered in the Chamber of Commerce or may have ceased trading in the Chamber of Commerce)","error":1214,"data":null}},"1215":{"value":{"success":false,"message":"found several locations, specify cciaa","error":1215,"data":null}},"1216":{"value":{"success":false,"message":"no company matches this id: 697ce19f5610b4a8910670c4","error":1216,"data":null}},"1217":{"value":{"success":false,"message":"no company found","error":1217,"data":null}},"1218":{"value":{"success":false,"message":"no company found","error":1218,"data":null}}}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"examples":{"704":{"value":{"success":false,"message":"malformed 'url' parameter, must be a valid url in 'callback'","error":704,"data":null}},"706":{"value":{"success":false,"message":"'url' parameter must start with 'http' or 'https'","error":706,"data":null}},"708":{"value":{"success":false,"message":"Headers not valid, must be an object with key : value","error":708,"data":null}},"709":{"value":{"success":false,"message":"Exceeded maximum length (256 chr) of the key: ","error":709,"data":null}},"710":{"value":{"success":false,"message":"The value of '$key' must be a string","error":710,"data":null}},"711":{"value":{"success":false,"message":"Exceeded maximum length (2kb) of the headers: ","error":711,"data":null}},"730":{"value":{"success":false,"message":"Invalid 'custom' Parameter too big max:512b","error":730,"data":null}},"740":{"value":{"success":false,"message":"Invalid retry Parameter min:0 max:5","error":740,"data":null}},"1208":{"value":{"success":false,"message":"empty monitoredFields","error":1208,"data":null}},"1210":{"value":{"success":false,"message":"pec is not an allowed field for IT-name; choose between [\\\"taxCode\\\",\\\"vatCode\\\",\\\"companyName\\\",\\\"address.registeredOffice.town\\\",\\\"creationTimestamp\\\",\\\"lastUpdateTimestamp\\\"]","error":1210,"data":null}}}}}},"428":{"description":"Precondition Required","content":{"application/json":{"examples":{"1206":{"value":{"success":false,"message":"dataset required","error":1206,"data":null}},"1209":{"value":{"success":false,"message":"code required","error":1209,"data":null}}}}}}}}},"/monitor/{id}":{"get":{"tags":["Monitor"],"summary":"Get specific request","description":"Endpoint that returns the request marked by the identifier passed in the path.\n\nIn a test environment, you can make a synchronous call that simulates system control over the company fields you want to monitor. Simply execute a GET on this URL: https://test.company.openapi.com/monitor/{id}?callback","parameters":[{"name":"id","in":"path","description":"request id","required":true,"schema":{"type":"string","example":"66c881896de559cb65055392"}},{"name":"callback","in":"query","description":"simulates system control over the company fields you want to monitor (only in test environment)","required":false,"allowEmptyValue":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MonitorRequest"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"code":"12485671007","dataset":"IT-advanced","monitoredFields":["pec"],"callback":{"method":"JSON","url":"https://webhook.site/28a4dddf-eca1-47f2-88d8-94878995e4d8","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"owner":"gcloud-tests@openapi.it","createdOn":"2026-02-03","companyId":"60d1bfc731177b0a092cdfc1","vatCode":"12485671007","taxCode":"12485671007","companyName":"OPENAPI S.P.A.","updatedFields":{"pec":"openapi@legalmail.it"},"latestDataset":{"taxCode":"12485671007","vatCode":"12485671007","companyName":"OPENAPI S.P.A.","address":{"registeredOffice":{"toponym":"VIALE","street":"F TOMMASO MARINETTI","streetNumber":"221","streetName":"VIALE F TOMMASO MARINETTI 221","town":"ROMA","hamlet":null,"province":"RM","zipCode":"00143","gps":{"coordinates":[12.47843,41.8071]},"region":{"code":"12","description":"LAZIO"},"townCode":"H501"}},"activityStatus":"ATTIVA","reaCode":"1378273","cciaa":"RM","atecoClassification":{"ateco":{"code":"6201","description":"Produzione di software non connesso all'edizione"}},"detailedLegalForm":{"code":"SP","description":"SOCIETA' PER AZIONI"},"startDate":"2013-10-20","registrationDate":"2013-07-19","endDate":null,"pec":"openapi@legalmail.it","taxCodeCeased":false,"taxCodeCeasedTimestamp":1708699396,"vatGroup":{"vatGroupParticipation":false,"isVatGroupLeader":false,"registryOk":true},"sdiCode":"USAL8PV","sdiCodeTimestamp":1709049141,"creationTimestamp":1624358855,"lastUpdateTimestamp":1708705000,"balanceSheets":{"last":{"year":2022,"employees":14,"balanceSheetDate":"2022-12-31","turnover":4043407,"netWorth":166491,"shareCapital":50000,"totalStaffCost":604997,"totalAssets":1483126,"avgGrossSalary":43214},"all":[{"year":2024,"employees":15,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":50000},{"year":2023,"employees":15,"balanceSheetDate":null,"turnover":null,"netWorth":null,"shareCapital":50000},{"year":2022,"employees":14,"balanceSheetDate":"2022-12-31","turnover":4043407,"netWorth":166491,"shareCapital":50000,"totalStaffCost":604997,"totalAssets":1483126,"avgGrossSalary":43214},{"year":2021,"employees":15,"balanceSheetDate":"2021-12-31","turnover":4432761,"netWorth":469366,"shareCapital":50000},{"year":2020,"employees":14,"balanceSheetDate":"2020-12-31","turnover":4192138,"netWorth":170234,"shareCapital":10000},{"year":2019,"employees":14,"balanceSheetDate":"2019-12-31","turnover":1799587,"netWorth":111309,"shareCapital":10000},{"year":2018,"employees":null,"balanceSheetDate":"2018-12-31","turnover":1325358,"netWorth":826,"shareCapital":null},{"year":2017,"employees":null,"balanceSheetDate":"2017-12-31","turnover":1120176,"netWorth":2928,"shareCapital":null}]},"shareHolders":[{"companyName":"OPEN HOLDING S.R.L.","name":null,"surname":null,"taxCode":"16935371001","percentShare":100}],"id":"60d1bfc731177b0a092cdfc1"},"previousDataset":null,"checkedOn":"2026-02-03","nextOn":"2026-03-05","expiresOn":"2027-02-03","autorenew":true,"id":"6981e3571a222556460af532"},"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no monitoring request matches this id: 66c881896de559cb65055393","error":1202,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"id not valid","error":1201,"data":null}}}}}},"delete":{"tags":["Monitor"],"summary":"Delete request monitor","description":"This endpoint allows you to delete a monitoring on a company","parameters":[{"name":"id","in":"path","description":"request id","required":true,"schema":{"type":"string","example":"68d552b647587376560a41d2"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[],"success":true,"message":"1 deleted monitor","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"no monitoring request matches this id: 60d1bfc731177b0a092cdfc2","error":1205,"data":null}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"id not valid","error":1204,"data":null}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"id required","error":1203,"data":null}}}}}}}},"externalDocs":{"description":"First time here? Generate a new access token","url":"https://console.openapi.com/oauth"},"security":[{"bearerAuth":[]}]}