# GET /v1/entity/{ico}

Kompletný detail firmy podľa IČO. Vracia všetky dostupné polia vrátane právnej formy, dátumu vzniku a zániku, registračných údajov a zdrojových metadát.

```bash
curl "https://api.subjekt.sk/v1/entity/31322832?country=sk"
```

## Parametre

| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| `ico` | string (path) | áno | IČO firmy — presne 8 číslic |
| `country` | string | nie | Krajina: `sk` alebo `cz`. Ak nie je zadaná, API najprv skúsi SK, potom CZ. |

## Odpoveď (200)

```json
{
  "ico": "31322832",
  "name": "SLOVNAFT, a.s.",
  "address": {
    "street": "Vlčie hrdlo",
    "building_no": "1",
    "city": "Bratislava",
    "zip": "82412",
    "country": "SK"
  },
  "legal_form": "Akciová spoločnosť",
  "legal_form_code": "121",
  "dic": "2020372640",
  "ic_dph": "SK7120001713",
  "established": "1992-05-01",
  "terminated": null,
  "registration": {
    "office": "Mestský súd Bratislava III",
    "number": "Sa/426/B"
  },
  "source": "subjekt.sk",
  "updated_at": "2026-03-24",
  "source_country": "sk",
  "source_system": "rpo",
  "dic_source_system": "fs",
  "source_license_class": "cc_by_4_0",
  "source_terms_url": "https://susrrpo.docs.apiary.io/"
}
```

Popis všetkých polí nájdete v [schémach odpovedí](../schemy-odpovedi.md).

## Chyba (404)

```json
{
  "code": "not_found",
  "message": "No entity found with ICO 12345670",
  "request_id": "f94251a8-f011-4a98-bf7c-5f1fc45f4abc"
}
```

## Poznámky k správaniu

- Ak parameter `country` nie je zadaný, API najprv hľadá v SK databáze. Ak nenájde, automaticky skúsi CZ (ARES proxy).
- Pri `country=sk` a nenájdenej firme vráti `404 not_found` bez prístupu na ARES.
- Pri `country=cz` sa upstream 5xx ARES mapuje na `502 upstream_unavailable` a timeout na `504 timeout`.
- Pole `terminated` obsahuje dátum zániku evidovaný v zdroji; `null` znamená, že v dostupnom zázname dátum zániku nie je. Zohľadnite [aktuálnosť dát](../aktualnost-dat.md).
- `404` znamená nenájdený záznam v službe, nie dôkaz neexistencie firmy.
- Pole `legal_form_code` je dostupné iba pre SK entity; pre CZ je vždy `null`.
- CZ dáta sú informatívne, pozri [Prehľad](../prehlad.md). Limity a hlavičky sú na stránke [Rate limity](../rate-limity.md).

## Návody na integráciu

- [Fakturačné údaje podľa IČO](../fakturacne-udaje.md)
- [DIČ a IČ DPH podľa IČO](../dic-ic-dph.md)