free · public · v1

Jedno API na údaje
každej SK/CZ firmy.

Názov, IČO, DIČ, IČ DPH, adresa, právna forma — všetko z jedného GET requestu. Bez registrácie, bez API kľúča. Docs a OpenAPI spec optimalizované pre IDE, LLM aj AI coding agentov.

Vyskúšaj priamo tu — zadaj názov alebo IČO:

{
  "stav": "pripravený",
  "tip": "zadaj názov firmy alebo IČO a klikni Hľadať"
}

endpointy

Čo získaš vo V1

Malý, deterministický API surface. Jasné správanie, predikovateľné responses.

Vyhľadávanie

GET /v1/search — hľadaj podľa názvu alebo IČO, filtruj SK/CZ, stránkuj cez cursor.

Detail entity

GET /v1/entity/{ico} — normalizovaný detail so source metadátami a country fallback.

Health a freshness

GET /v1/health — stav API, počet entít, posledný sync, lag.


integrácia

Skopíruj a použi

curl, JavaScript, Python, PHP — funguje okamžite, bez SDK, bez inštalácie.

bashsearch request
curl "https://api.subjekt.sk/v1/search?q=slovnaft&country=sk&limit=5"
javascriptfetch + async/await
const res = await fetch(
  "https://api.subjekt.sk/v1/search?q=slovnaft&country=sk&limit=5"
);
const data = await res.json();
console.log(data.results);
pythonrequests
import requests

r = requests.get("https://api.subjekt.sk/v1/search",
    params={"q": "slovnaft", "country": "sk", "limit": 5},
    timeout=8)
r.raise_for_status()
print(r.json()["results"])
phpfile_get_contents
$url = "https://api.subjekt.sk/v1/entity/31322832?country=sk";
$json = file_get_contents($url);
$data = json_decode($json, true);
print_r($data);

3
verejné endpointy
<80ms
SK search p95
0
auth pre v1
24h
max sync lag

pre llm & ai agentov

Navrhnuté pre AI workflow

OpenAPI spec, llms.txt, a docs v markdown — naskopíruj kontrakt priamo do LLM kontextu.

Tip: Skopíruj obsah openapi.yaml priamo do LLM chatu pre presný kontext o API parametroch a response schémach. Alebo použi llms.txt ako štartovací bod.

Dokumentácia

SK a EN docs v parite. Rozdelené podľa integračných úloh.