REST API pro české firmy

Všechna data o firmách
z jednoho API

Konsolidovaná data z ARES, ISIR a RUIAN. Cache-first architektura,
enrichment na pozadí, webhook notifikace o změnách.

GET api.firmy.corfuse.com/api/v1/companies/26168685/

Proč Corfuse Firmy

Cache-first

Data se cachují v PostgreSQL. Odpověď pod 50ms pro známé firmy. Stale data se refreshují na pozadí.

🔄

Automatický enrichment

Při prvním dotazu na IČO se data stáhnou z ARES, geocodují přes RUIAN a zkontrolují v ISIR.

🔔

Webhooky

Registrujte endpoint a dostávejte notifikace při změně firemních dat nebo insolvence.

🛡️

Insolvence

Automatická kontrola ISIR — zjistěte insolvenční stav firmy ještě před uzavřením obchodu.

📍

Geocoding

GPS souřadnice sídla z RUIAN. Okres, kraj — filtrace firem podle regionu.

🔑

API klíče

M2M autentizace přes X-API-Key. Per-service permissions, rate limiting.

API Endpoints

GET /api/v1/companies/{ico}/ Detail firmy (cache-first)
GET /api/v1/companies/?name=&nace=®ion= Vyhledávání a filtrování
POST /api/v1/companies/{ico}/refresh/ Vynutit aktualizaci dat
GET /api/v1/nace/ Klasifikace CZ-NACE
GET /api/v1/stats/ Statistiky databáze

Kompletní dokumentace na Swagger UI

Datové zdroje

ARES

Ministerstvo financí ČR

IČO, název, DIČ, právní forma, adresa, datum vzniku, NACE kódy

ISIR

Ministerstvo spravedlnosti ČR

Insolvenční řízení — spisová značka, stav, aktivní vs ukončené

RUIAN

ČÚZK

GPS souřadnice sídla, okres, kraj, kód adresního místa

CZ-NACE

ČSÚ

Klasifikace ekonomických činností — 88 kategorií s českými i anglickými popisky