# FirmAPI – What data we provide We aggregate and cross-verify data from dozens of authoritative Slovak and European registers. Below is the full list of fields our REST API returns. One call, dozens of registers. Instead of scraping ORSR, downloading ZIP files from the Tax Authority and calling the VIES SOAP service, you get all company data in a single HTTP request. Data is refreshed on each source's native cadence – from real-time VAT validation, through daily imports of insolvencies and contracts, to weekly refreshes of RPO. FirmAPI aggregates and cross-checks 55 public registers and covers 2,100,000+ entities with a company ID (IČO). Every value in a response names its source register and the time of the last sync. ## How to read this list - Core data – available on all plans including the free tier - Enriched data – available on paid plans by tier - Source indicates the authoritative register the field comes from ## Response fields by category ### 1. Company identification (Core) Basic identifiers that uniquely identify a subject. - **ICO** – Eight-digit Slovak company registration number. - **Company name** – Official name of the company as registered. - **Legal form** – Code and description (e.g. LLC, JSC, sole trader). - **ORSR ID** – Commercial register identifier if the company is listed there. - **Source register** – Indicates whether the company comes from RPO or the Commercial Register. - **Status** – Active or inactive company. - **SK-NACE** – Code and description of the main economic activity. - **Incorporation date** – Date the company was entered into the register. - **Termination date** – Date the company ceased activity, if applicable. ### 2. Address and registered office (Core) Registered address with structured components. - **Street and number** – Structured street, orientation and building number. - **City** – City or municipality of the registered office. - **Postal code** – Postal routing code. - **Country** – ISO 3166 country code. - **Verified address from ORSR** – Detailed address pulled directly from the Commercial Register. ### 3. Statutory bodies and shareholders (Core) Complete ownership and management structure from the Commercial Register. - **Shareholders** – Name, address, capital contribution and ownership share of each partner. We distinguish natural persons and legal entities (including ICO for legal entities). - **Statutory bodies** – Names of directors or board members, their role, address and method of acting. - **Business activities** – Full list of activities registered in the Commercial Register. - **Registered capital** – Amount of registered capital and paid-up status. ### 4. Tax and VAT data (Enriched) Complete set of tax identifiers and their verification in Slovak and European registers. - **DIC (Tax ID)** – Tax identification number from the RegisterÚZ dataset. - **IC DPH (VAT ID)** – VAT identification number from the Slovak Tax Authority list. - **VAT payer status** – Current status from the weekly updated Tax Authority list. - **VIES verification** – Real-time VAT ID verification via the European Commission service, including the last check date. - **Assigned tax office** – The tax office responsible for the company. - **Tax reliability index** – Rating from the Tax Authority (reliable, less reliable, unreliable). - **Erased from VAT register** – Whether the subject was removed from the VAT register, including the date and reason. ### 5. Tax Authority registers (Enriched) Eleven separate datasets the Slovak Tax Authority publishes alongside the VAT payer register. - **Notified bank accounts** – Accounts a VAT payer notified to the Tax Authority. Paying an unnotified account creates joint liability for the tax. - **Excess VAT deductions** – Granted excess deductions by tax period, including the amount. - **Special VAT scheme (section 68d)** – Cash-accounting VAT treatment including the start and end dates. - **VAT deregistration reasons** – Year of the breach and publication date where registration was cancelled for a breach of obligations. - **Corporate income tax** – Assessed tax and declared tax loss per tax period. - **R&D and investment deductions** – The section 30c research deduction, the section 30e investment deduction and the section 13 income exemption. - **Register of regulated persons** – Type of regulation and the period during which the entity is subject to the special levy. ### 6. Financial data and annual statements (Enriched) Annual financial results sourced from publicly published financial statements. - **Revenue** – Annual revenue from the sale of goods and services. - **Profit or loss** – Net profit or loss for the accounting period. - **Total assets** – Total value of company assets. - **Equity** – Equity value at the end of the accounting period. - **Liabilities** – Total short-term and long-term liabilities. - **Employee count** – Average registered number of employees per the financial statement. - **Financial statements history** – Access to multi-year history including statement type (micro, small, large accounting entity). ### 7. Bank accounts (Enriched) Published bank accounts from the Tax Authority register. - **IBAN** – International bank account number. - **Bank name** – Name of the financial institution. ### 8. Debtor lists and arrears (Enriched) Cross-checked information on whether the company has outstanding debts to the state or health insurers. - **Social Insurance Agency** – Outstanding amounts owed to Sociálna poisťovňa, including amount and publication date. - **Tax Authority** – Tax arrears owed to the Slovak Tax Authority. - **General Health Insurance (VšZP)** – Outstanding amounts owed to VšZP. - **Dôvera Health Insurance** – Outstanding amounts owed to Dôvera. - **Union Health Insurance** – Outstanding amounts owed to Union. ### 9. Insolvency and execution proceedings (Enriched) Bankruptcy, restructuring and enforcement proceedings against the company. - **Insolvency proceedings** – Proceeding type (bankruptcy, restructuring, liquidation), case number, court, administrator and dates. - **Execution authorizations** – ECLI, court file number, bailiff name, enforced claim and authorization dates. - **Insolvency administrator** – Where the entity is a registered administrator: licence number, district and validity. ### 10. Commercial Bulletin (Enriched) Announcements and notices published in the Slovak Commercial Bulletin. - **Commercial Bulletin entries** – Section, heading and publication date of the latest notices plus the total count. ### 11. Public sector (Enriched) Government contracts, public procurement awards and public sector partner registration. - **Public contracts (CRZ)** – Number and total value of contracts published in the Central Registry of Contracts. - **Public procurement** – Number and total value of awarded tenders from Úrad pre verejné obstarávanie. - **RPVS – public sector partners** – RPVS registration, validity of the entry and list of ultimate beneficial owners. - **Central Project Register** – Publicly financed projects including the provider and the amount of support. - **EU funds 2021 – 2027 (ITMS21+)** – EU-funded projects, grant applications, irregularities and receivables, and EU-funded procurement contracts. - **European tenders (TED)** – Contract notices published in the EU official journal, including value. ### 12. Public Procurement Office registers (Enriched) A company standing in public procurement – qualification, buyer status, bans and references. - **Register of economic operators** – A valid qualified supplier entry including the registration number and validity. - **Contracting authority** – Whether the entity is recorded as a contracting authority, including its classification. - **Procurement debarment** – Current and expired bans, the reason imposed and the period they cover. - **Supplier references** – Count and value of references from completed contracts, with the buyer and the rating. ### 13. Employment (Enriched) Company size in people and records of breaches of employment rules. - **Illegal employment** – National Labour Inspectorate records including the date of the breach and the decision number. ### 14. Sanctions and international identity (Enriched) Screening against sanctions lists and the global legal entity identifier. - **EU and OFAC sanctions lists** – Matches against the EU consolidated list and the OFAC lists, with a match score and a regulation reference. - **LEI identifier** – Global Legal Entity Identifier including links to the direct and ultimate parent. ### 15. Licences and sectoral registers (Enriched) Authorisations and statuses without which a company may not operate in its sector. - **NBS licenses** – List of licenses and permits issued by the National Bank of Slovakia. - **Energy regulator licences** – Network industry licences by segment, including validity. - **Registered social enterprise** – Granted status, enterprise type, certificate number and date granted. - **Travel agencies** – Insolvency insurance, insured amount, validity and any ban on activity. - **Approved food establishments** – Food and veterinary establishments with an approval number and approved activity. ## All data sources (55) FirmAPI downloads and cross-joins data from these 55 authoritative registers on each source's native publication cadence. Every field in a response is tagged with its source, so you always know where a value came from. - **RPO – Legal Entities Register** – Master register of all legal entities in Slovakia. Identification, legal form and registered office. - **Slovak Commercial Register (ORSR)** – Shareholders, directors, registered capital, business activities, certified extracts. - **Register of Financial Statements** – Tax ID (DIČ), complete annual financial statements and multi-year history. - **SK-NACE (Statistical Office)** – Classification of economic activities maintained by the Slovak Statistical Office. - **Tax Authority – VAT payers** – Current list of VAT payers including VAT IDs, refreshed weekly. - **Tax Authority – Tax reliability index** – Tax reliability rating assigned by the Slovak Tax Authority. - **Tax Authority – Erased VAT payers** – Companies removed from the VAT register with date and reason. - **EU VIES** – European Commission service for real-time VAT ID verification. - **Tax Authority – VAT payer bank accounts** – Bank accounts a VAT payer has notified to the Slovak Tax Authority. Paying to an unnotified account creates joint liability for the tax. - **Tax Authority – Excess VAT deductions** – Entities granted an excess VAT deduction, including the tax period concerned. - **Tax Authority – Special VAT scheme** – VAT payers applying the cash-accounting special scheme under section 68d of the Slovak VAT Act. - **Tax Authority – VAT deregistration reasons** – The reason a VAT registration was cancelled, with the date of cancellation. - **Tax Authority – Corporate income tax** – Published corporate income tax data per tax period. - **Tax Authority – Income tax registration** – Record of the entity registration for income tax, including the registration date. - **Tax Authority – Taxpayer personal accounts** – Personal taxpayer account numbers assigned by the Tax Authority for tax payments. - **Tax Authority – R&D tax deduction** – Entities claiming the research and development expense deduction under section 30c of the Income Tax Act. - **Tax Authority – Investment tax deduction** – Entities claiming the investment expense deduction under section 30e of the Income Tax Act. - **Tax Authority – Income tax exemption** – Entities with income exempted under section 13 of the Income Tax Act. - **Tax Authority – Regulated persons register** – Persons subject to the special levy in regulated industries, maintained by the Tax Authority. - **Social Insurance Agency – debtors** – List of debtors owed to the Social Insurance Agency with outstanding amounts. - **Tax Authority – tax debtors** – Tax debtors published by the Slovak Tax Authority. - **VšZP – debtors** – Debtors of the General Health Insurance company (VšZP). - **Dôvera – debtors** – Debtors of the Dôvera health insurance company. - **Union – debtors** – Debtors of the Union health insurance company. - **Insolvency Register** – Bankruptcy, restructuring and liquidation proceedings of Slovak companies. - **Slovak Commercial Bulletin** – Official notices and announcements published in the Commercial Bulletin. - **RPVE – Execution authorizations** – Register of court authorizations empowering bailiffs to enforce claims against subjects. - **Labour Inspectorate – Illegal employment** – List of employers fined for illegal employment. - **REPLIK – Register of administrators** – Register of bankruptcy and restructuring administrators. - **Court decisions (MS SR)** – Decisions of Slovak courts in which the company is a party to the proceedings. - **CRZ – Central Registry of Contracts** – Public contracts signed with the state and public administration. - **Public procurement** – Tenders in which the company is a winning bidder or supplier. - **ITMS2014+ (EU funds)** – Recipients of EU structural funds including allocated amounts and project details. - **ITMS21+ (EU funds 2021 – 2027)** – Projects, grant applications, irregularities, receivables and contracts from the 2021 – 2027 EU funding period. - **CRP – Central Project Register** – Publicly funded projects including the beneficiary, the amount of support and the project status. - **PPO – Register of economic operators** – Register of qualified suppliers maintained by the Public Procurement Office (ÚVO). - **PPO – Contracting authorities** – Entities recorded as public contracting authorities including their classification. - **PPO – Procurement ban** – List of entities banned from participating in public procurement. - **PPO – References register** – Ratings and references for companies from completed public contracts. - **RPVS – Public Sector Partners** – Register of public sector partners including ultimate beneficial owners. - **TED – Tenders Electronic Daily** – European public tenders published in the Official Journal of the EU. - **EU – Consolidated sanctions (FSF)** – European Union consolidated financial sanctions list. - **OFAC – US sanctions lists** – Sanctions lists of the US Treasury Office of Foreign Assets Control (OFAC). - **GLEIF – LEI identifier** – Global Legal Entity Identifier (LEI) including parent company relationships. - **NBS – Financial market entities** – Licensed financial institutions regulated by the National Bank of Slovakia. - **RONI – Permit holders** – Entities holding permits in network industries (energy, water) regulated by RONI (ÚRSO). - **Register of social enterprises** – Companies granted the status of a registered social enterprise. - **SOI – Travel agency register** – Travel agencies including insolvency insurance and any bans. - **SVPS – Approved establishments** – Approved food and veterinary establishments supervised by the State Veterinary and Food Administration. - **MoI SR – Private security register** – Holders of licences to operate a private security service. - **JISCD – Carrier register** – Holders of licences and EU licences for road transport operations. - **Notarial Chamber – 2% tax-assignment recipients** – Annual list of organisations eligible to receive assigned income tax, including IČO and published bank details. - **Recovery and Resilience Plan** – Applicants and recipients under the Slovak Recovery and Resilience Plan, including projects and requested amounts. - **ÚKSÚP – producers, importers and exporters** – Register of businesses engaged in agricultural production, importing or exporting. - **PPA – agricultural direct-support applicants** – IČO-linked applicants and requested schemes from the PPA annual direct-support campaign. ## Coming soon ## How to access the data All fields are available over REST. A single HTTP request returns a complete JSON company object, and you control the enrichment scope with a parameter. https://api.firmapi.sk/en/docs.md - Company lookup by ICO – `GET /v1/company/ico/{ico}?scope=all` - Company lookup by ORSR ID – `GET /v1/company/id/{orsrId}` - Search by name – `GET /v1/search/name?q=` - Autocomplete for forms – `GET /v1/search/autocomplete?q=` - Advanced search across multiple criteria – `GET /v1/search/advanced` - Batch lookup of multiple ICOs at once – `POST /v1/batch/ico` - Batch search by a list of names – `POST /v1/batch/names` - Webhooks for notifications on every data change – `POST /v1/notifications` Example response of `GET /v1/company/ico/51636549?scope=all`: ```json { "data": { "ico": "51636549", "name": "Version Two s. r. o.", "legal_form": "Spoločnosť s ručením obmedzeným", "legal_form_code": "112", "address": { "street": "Mlynské nivy 48", "city": "Bratislava", "postal_code": "82109", "country": "SK" }, "established_date": "2018-03-15", "terminated_date": null, "source_register": "orsr", "status": "active", "orsr_id": "127891/B", "business_activities": [ { "activity": "Počítačové služby", "since": "2018-03-15" }, { "activity": "Poskytovanie softvéru – predaj hotových programov", "since": "2018-03-15" }, { "activity": "Reklamné a marketingové služby", "since": "2020-11-04" } ], "registered_capital": "5 000 EUR", "shareholders": [ { "name": "Mgr. Mario Chamuty", "address": "Bratislava", "share_amount": "5 000 EUR", "share_percentage": "100%", "is_company": false, "ico": null } ], "statutory_body": [ { "name": "Mgr. Mario Chamuty", "role": "konateľ", "address": "Bratislava, Slovensko", "acting_method": "Za spoločnosť koná konateľ samostatne." } ], "nace_code": "62010", "nace_description": "Počítačové programovanie", "tax": { "dic": "2120876543", "ic_dph": "SK2120876543", "vies_valid": true, "vies_verified_at": "2026-04-11T06:00:00+00:00", "is_vat_payer": true }, "tax_reliability": { "index": "spoľahlivý", "is_reliable": true }, "erased_vat": { "is_erased": false, "entries": [] }, "bank_accounts": [ { "iban": "SK89 1100 0000 0029 4305 4158", "bank_name": "Tatra banka, a. s.", "is_published": true } ], "financials": { "year": 2024, "accounting_basis": "double_entry", "net_turnover": 420680, "sales_revenue": 420680, "total_income": 423110, "net_profit": 68420, "total_assets": 315200, "total_equity": 187450, "total_liabilities": 127750, "total_receipts": null, "total_expenditures": null, "receipts_minus_expenditures": null }, "financial_statements": { "latest": { "year": 2024, "statement_type": "riadna", "accounting_basis": "double_entry", "template_family": "POD", "net_turnover": 420680, "sales_revenue": 420680, "total_income": 423110, "net_profit": 68420, "total_assets": 315200, "total_equity": 187450, "total_liabilities": 127750, "figure_sources": { "net_turnover": "Úč POD (699): Výkaz ziskov a strát r. 01", "total_income": "Úč POD (699): Výkaz ziskov a strát r. 02 + r. 29" } }, "available_years": [2021, 2022, 2023, 2024] }, "debtor_status": { "is_debtor": false, "sources": [] }, "insolvency": { "has_active_proceedings": false, "proceedings": [] }, "execution_authorizations": { "has_active_authorizations": false, "total_count": 0, "authorizations": [] }, "commercial_bulletin": { "total_entries": 12, "latest_entries": [ { "section": "Zbierka listín", "heading": "Účtovná závierka 2024", "published_at": "2025-06-12" }, { "section": "Zmeny v OR", "heading": "Zmena sídla spoločnosti", "published_at": "2024-09-03" } ] }, "public_contracts_summary": { "count": 3, "total_value": 48700.00 }, "procurement_summary": { "count": 1, "total_awarded_value": 24500.00 }, "rpvs": { "is_public_sector_partner": false, "registrations": [] }, "nbs": { "is_regulated": false, "license_types": [], "categories": [], "entity_id": null, "is_natural_person": false, "licences": [], "agents_count": 0 }, "reges": { "is_qualified_supplier": true, "registration_id": "...", "valid_to": "2027-09-01" }, "debarred": { "is_debarred": false, "is_listed": false }, "uvo_references": { "count": 2, "total_value": 41200.00, "currency": "EUR", "latest": [] }, "crp_projects": { "count": 0, "total_value": 0.00, "currency": "EUR", "latest": [] }, "illegal_employment": { "listed": false, "count": 0, "since": null, "entries": [] }, "sanctions": { "eu_fsf_hits": [], "ofac_hits": [], "total_hits": 0 }, "gleif": null, "fs": { "dsrdp_registered": true, "dphno": [], "dpho": [], "dphz": [], "regulated": [] } }, "meta": { "rpo_updated_at": "2026-04-11T04:15:00+00:00", "source": "database", "orsr_synced_at": "2026-04-10T22:40:11+00:00", "enriched_at": "2026-04-11T05:02:48+00:00", "profile_built_at": "2026-04-11T05:02:49+00:00" } } ``` ## Data freshness Every response includes metadata about data freshness, so you always know how old the values are. (`meta.*_at`) - **RPO – weekly sync** – The master legal entity register is synchronized once a week, typically on Sunday mornings. - **ORSR – on-demand enrichment** – Commercial Register details are fetched asynchronously on the first lookup. Existing records are automatically refreshed once they exceed 30 days. - **Tax Authority – weekly** – VAT payer list, erased VAT payers and tax reliability index are imported weekly. - **VIES – real-time** – VAT ID verification runs directly against the European Commission service on each request. - **Debtor lists – weekly to monthly** – Social Insurance Agency is refreshed weekly; the Tax Authority and health insurers (VšZP, Dôvera, Union) follow their monthly publication schedule. ## More resources - API documentation: https://api.firmapi.sk/en/docs.md - Use cases: https://api.firmapi.sk/en/use-cases.md - Pricing: https://api.firmapi.sk/en/pricing.md - Company verification: https://api.firmapi.sk/en/verify-company.md - Company monitoring: https://api.firmapi.sk/en/company-monitoring.md - Comparison with FinStat: https://api.firmapi.sk/en/compare/finstat.md - Sign up (no payment card needed): https://api.firmapi.sk/en/register --- Operated by Version Two s.r.o., https://www.versiontwo.sk