Changelog
All notable changes to FirmAPI.
v1.12.0
New pages, markdown output for AI tools and more reliable data
- ✓ New pages: Company verification, Company monitoring and a FirmAPI vs. FinStat comparison – a clear overview of what the service can do.
- ✓ Key pages now have markdown versions for AI assistants (e.g. /dokumentacia.md, /cennik.md) plus an /llms.txt index following the llms.txt convention.
- ✓ Faster and more reliable enrichment from the Public Sector Partners register (RPVS) – lookups no longer get lost during peaks.
- ✓ The execution authorizations import runs at full capacity again, and detail backfill no longer hammers the register with pointless repeated requests.
- ✓ Admin statistics now show real counts of execution authorizations, public sector partners, regulated entities, companies with SK-NACE and tax-unreliable companies.
- ✓ Fixed an occasional company search failure during registration.
v1.11.0
Data display, export and change-detection fixes
- ✓ Financial Administration import sections (VAT, income tax, research & investment deductions, exemptions, regulated entities) now display correctly according to your plan – previously they were unavailable.
- ✓ The company risk profile (debts, insolvency, illegal employment) is now truthful on every plan, including companies with a short company ID (IČO).
- ✓ Company export (PDF, JSON, Markdown) now also includes CRP projects (Project Register) and all Financial Administration sections.
- ✓ Change detection no longer reports false changes when only the ordering of fields in the data changed rather than their content (applies to all sources, e.g. ORSR registered capital).
- ✓ Company change e-mails are now human-readable – instead of raw JSON they show a clear field name and values (e.g. "Amount: 5 000 · Currency: EUR").
- ✓ The Upgrade page now offers a Custom option for individual limits and requirements.
v1.10.0
Complete SDK types & consistent scope=all
- ✓ JS/TS SDK: response types added for every scope – debtor lists, insolvency, commercial bulletin, public contracts, procurement, illegal employment, court decisions and employer headcount. TypeScript now knows the shape of each section.
- ✓ scope=all (withAll) now returns every section your plan includes – court decisions, illegal employment, employer headcount, travel agencies, veterinary establishments and Financial Administration imports.
- ✓ scope=all now consistently respects your plan – it returns exactly the sections your plan covers.
v1.9.0
Financial statements – multi-year series & latest-year fix
- ✓ Financial statements now return the full multi-year series (revenue, profit, equity, assets and liabilities per year), so trend charts can be drawn. Available via the `financial_statements` and `all` API scopes and in the JS SDK (new `FinancialStatementsInfo` type with a `statements` array).
- ✓ Fix: the "latest financial statement" sometimes showed the wrong (older) year instead of the most recent reporting period. It now always uses the newest year – in the API, on the company detail page and in the admin panel.
v1.8.0
CRP – Projects register (state & EU-funded projects)
- ✓ New data source: CRP – Register projektov (crp.gov.sk). The company panel now shows state- and EU-funded projects where the company is the beneficiary – project name, provider, type and amount of aid, dates and a link to the register detail.
- ✓ `crp_projects` scope added to PHP and JS SDKs (new `withCrpProjects()` method).
- ✓ More reliable imports: a data source is no longer marked successful when nothing was actually downloaded, so an upstream outage is visible immediately.
v1.7.0
SVPS approved establishments + name+address fuzzy linking
- ✓ New data source: SVPS (Štátna veterinárna a potravinová správa SR) – every approved food and veterinary establishment in Slovakia. The company panel now shows approval numbers, section/activity, location and the establishment name for each registered site.
- ✓ New `NameAddressLinker` service used by sources that don't publish an IČO. SVPS establishments are matched to companies by name+city with a confidence score (≥ 0.80 to surface). Lower-confidence matches are stored but not exposed.
- ✓ `svps_establishments` scope added to PHP and JS SDKs (new `withSvpsEstablishments()` methods).
v1.6.0
SOI travel agency registry + RÚZ live refresh
- ✓ New data source: SOI – Travel agency registry. Each registered tour operator now exposes its insolvency protection provider, coverage amount, contract validity and any activity ban.
- ✓ Financial statements (RÚZ) are now refreshed automatically from the RÚZ live API on company detail view when older than 30 days – no longer dependent on the weekly bulk import.
- ✓ `soi_travel_agency` scope added to PHP and JS SDKs (new `withSoiTravelAgency()` methods).
- ✓ PHP and JS SDKs also gained the previously missing helpers `withFsImports()`, `withIllegalEmployment()`, `withCourtDecisions()`, `withEmployerHeadcount()`.
v1.5.0
NBS supervision: regulator categories surfaced as a separate field
- ✓ For NBS-regulated companies the response now includes supervision categories (e.g. Insurer, Bank, Crypto-asset service provider, Loan servicer) as distinct labels.
- ✓ Previously NBS data exposed only a flat list of scopes; the new structure distinguishes between the category (entity type) and the specific licensed activities.
- ✓ API responses in the `nbs` scope now include a `categories` array alongside the existing `license_types`.
- ✓ JS SDK bumped to v1.5.0 (extended the `nbs` type with `categories`).
v1.4.0
Financial Administration SR – 10 new tax data sources
- ✓ VAT excess deductions (§79) – per-period breakdown of approved excess VAT deductions, including the deduction amount and the company's own tax liability.
- ✓ VAT payers list – current VAT registrations with start and end dates for each registration.
- ✓ VAT deregistration reasons – history of cancelled VAT registrations with the year of cancellation.
- ✓ Corporate income tax (DPPO) – per-period summary of submitted tax returns including tax liability and any declared loss.
- ✓ Reliable VAT payer (DS RDP) – flag indicating whether the company is listed as a reliable VAT payer by the Financial Administration.
- ✓ Special accounts for tax debtors (OUD) – bank accounts published by the Financial Administration due to outstanding tax debt, including IBAN and bank code.
- ✓ R&D expense deductions – list of claimed research and development deductions with project description, deduction amount and start date.
- ✓ Investment incentives – tax relief drawn under investment projects, with investment volume and planned incentive percentage.
- ✓ Patent box (§13a) – income exemptions from intellectual property under the patent-box regime, with subtype, period and subject description.
- ✓ Regulated entities – companies monitored by the Financial Administration as regulated subjects, with type and validity window.
- ✓ All sources refresh daily from Financial Administration SR lists and are available under the new fs_imports scope.
- ✓ PHP and JS SDKs gain withFsImports() helper.
v1.3.0
ÚVO – four new public-procurement registers with daily refresh
- ✓ ÚVO REGES (qualified-supplier register) – reconnected and refreshed daily. For every company we now indicate whether it is a registered economic operator together with its registration number. Foreign suppliers are kept in their original ID format.
- ✓ ÚVO Contracting Authorities Register – new contracting_authority scope with the statutory section and classification label. Surfaced on the company panel, profile and API response.
- ✓ ÚVO Debarred Persons Register – new debarred scope with active-ban indicator, violation reason, ban window and related persons. Fires the debarred.updated webhook in the risk group.
- ✓ ÚVO Reference Records – new uvo_references scope with reference count, total contract value (EUR) and the 25 most recent contracts including document links, ratings and buyer names.
- ✓ All four ÚVO data sources refresh daily, staggered through the early morning so the data on the company panel and the API stays current.
- ✓ PHP + JS SDKs gain withContractingAuthority(), withDebarred() and withUvoReferences() helpers.
- ✓ New webhook events: contracting_authority.updated, debarred.updated, uvo_references.updated.
- ✓ The dashboard "Full refresh" and admin "Refresh all" buttons now kick off a full refresh across every data source – the new ÚVO sources land in the per-company overview shortly after the click.
v1.2.0
Sanctions screening, LEI, EU tenders and 6 more enrichment sources
- ✓ EU consolidated sanctions (FSF) and OFAC SDN/Consolidated screening – fuzzy-matched against every Slovak company by name with Jaro-Winkler. Hits surface under the new sanctions scope and fire a sanctions.match webhook on first detection.
- ✓ GLEIF LEI lookup – when a Slovak company has a Legal Entity Identifier registered with the Slovak statistical office, you get the LEI plus parent / ultimate-parent LEI under the gleif scope.
- ✓ UVO REGES (Zoznam hospodárskych subjektov) – qualified-supplier flag and registration validity under the reges scope.
- ✓ Register sociálnych podnikov – social-enterprise certification status, type, granted-at and revoked-at dates under the social_enterprise scope.
- ✓ TED (Tenders Electronic Daily v3) – EU-wide procurement notices the company appeared on as a buyer, under the ted_tenders scope.
- ✓ REPLIK – Zoznam správcov konkurznej podstaty – when the IČO matches a registered insolvency administrator, you get the licence number, region and validity under the replik_administrator scope.
- ✓ MV SR Register SBS – private-security-service licence under the sbs scope (NACE 80.* pre-filtered).
- ✓ JISCD register dopravcov – road-transport eurolicence and vehicle counts under the transport_licence scope (NACE 49.* pre-filtered).
- ✓ ÚRSO držitelia povolení – energy/gas/heat/water licence segments under the utility_licence scope (NACE 35.* / 36.* / 37.* pre-filtered).
- ✓ New webhook events: sanctions.match, qualified_supplier.updated, social_enterprise.updated, gleif.updated, ted_tender.published, insolvency_administrator.updated, sbs_licence.updated, transport_licence.updated, utility_licence.updated.
- ✓ PHP and JS SDKs add withSanctions(), withGleif(), withReges(), withSocialEnterprise(), withTedTenders(), withReplikAdministrator(), withSbs(), withTransportLicence(), withUtilityLicence() helpers.
v1.1.0
Credit-based billing replaces request limits
- ✓ Per-minute and daily request limits removed – they were a stupid idea, layered on top of the monthly quota for no good reason. Internally we already metered every request as a credit, so the new model is just exposing what was always there.
- ✓ Each plan now refills a credit balance every month. One API call = one credit. If you have credits, the API answers – no artificial pacing limits.
- ✓ Cached responses still cost zero credits, so high-traffic apps over the same companies stay cheap.
- ✓ Unused credits roll over to the next month (capped per plan) and remain valid for 3 months.
- ✓ New endpoints: GET /v1/account/quota and POST /v1/account/thresholds for setting custom low-balance alerts.
- ✓ Existing subscriptions stay on the legacy monthly-quota mode (without daily/per-minute limits) until you migrate from the dashboard.
v1.0.0
Public launch
- ✓ Sandbox API with 10 demo companies and a dedicated sandbox key for testing
- ✓ Company search and expanded company detail view in the admin dashboard
- ✓ New "What data we provide" subpage
v0.7.0
New regulatory data sources
- ✓ RPVE integration (Register of execution authorizations)
- ✓ NBS integration – Slovak financial market entities
- ✓ SK-NACE code enrichment from the Slovak Statistical Office
- ✓ RPVS integration (Register of Public Sector Partners)
- ✓ Tax reliability index and erased VAT payers imports
v0.6.0
Support and UX
- ✓ Support ticket system with assignment, auto-status and attachments
- ✓ Rich-text editor and notification badges for messages
- ✓ Custom error pages
v0.5.0
Faster search
- ✓ Company name search is now up to 25x faster
v0.4.0
Deeper RPO data
- ✓ EU-funded public procurement imports (ITMS2014+)
- ✓ VšZP debtor data
- ✓ On-demand RPO company lookups
- ✓ Stakeholders, statutory bodies and registered equity from RPO
v0.3.0
Enrichment, auth and billing
- ✓ 9 new public data sources: financial statements, 5 debtor lists, public procurement, insolvencies, commercial bulletin, ORSR
- ✓ "Enrich All" admin action
- ✓ Email verification with branded email templates
- ✓ Optional two-factor authentication for dashboard and admin
- ✓ Admin custom billing management (prices, discounts, notes)
- ✓ Company registration with live company lookup and Stripe billing prefill
- ✓ Rate limiting on the public company lookup endpoint
- ✓ Opt-in enrichment via the ?scope= query parameter
- ✓ Fluent builder pattern in PHP and JS SDKs
v0.2.0
Freshness and reliability
- ✓ Weekly RPO data refresh with automatic recovery
- ✓ Automatic refresh of outdated company data
- ✓ XML sitemap
- ✓ Real company count on the homepage
v0.1.0
Initial launch
- ✓ REST API for Slovak company lookup by IČO and ORSR ID
- ✓ User and admin panel, API key and subscription management
- ✓ Webhook system and notifications UI
- ✓ PHP and JavaScript SDKs (MIT licensed)
- ✓ Full Slovak and English localization
- ✓ Response caching – cache hits consume no credits