---
title: "Detail firmy podle IČO"
method: GET
path: "/api/v1/firma/{ico}"
---

# Detail firmy podle IČO

`GET /api/v1/firma/{ico}`

## Request

- Base URL: `https://firmastat.cz`
- URL: `https://firmastat.cz/api/v1/firma/{ico}`
- Auth: one of:
  - none
  - HTTP bearer

Vedle údajů z rejstříků nese objekt `dph` (DIČ, stav registrace, plátce / nespolehlivý plátce / identifikovaná osoba, zveřejněné účty) a `sidlo.textPlny` s nezkrácenou adresou včetně městské části. `dph: null` znamená NEOVĚŘENO, nikdy „není plátce".

## Path parameters

- `ico` string, required

## Response `200`

Detail firmy

- object
  - `ok` boolean
  - `data` object
    - `ico` string
    - `obchodniJmeno` string
    - `dic` string
    - `sidlo` object
      - `text` string
      - `textPlny` string: Nezkrácená adresa z ARES vč. městské části a čísla obvodu.
      - `kodKraje` integer
      - `nazevKraje` string
      - `psc` integer
    - `dph` object, nullable: Stav DPH složený z ARES (registrace, DIČ) a CRPDPH MFČR (typ, nespolehlivost). `null` = NEOVĚŘENO — nikdy to neznamená „není plátce".
      - `dic` string, nullable: DIČ včetně prefixu. Neodvozuje se z IČO (u FO je z rodného čísla). `null` i po zániku registrace — mrtvé DIČ na faktuře je horší než žádné.
      - `registraceAktivni` boolean: Běží registrace k DPH právě teď.
      - `stav` 'platce' | 'nespolehlivyPlatce' | 'identifikovanaOsoba' | 'neplatce', nullable
      - `nespolehlivyOd` string, date, nullable
      - `overenoK` string, date-time: Stáří snapshotu, o který se odpověď opírá (starší z obou zdrojů).
      - `cisloFu` string, nullable
      - `zverejneneUcty` string[]: Zveřejněné bankovní účty (§109 — platba jinam nese stejné riziko jako nespolehlivý plátce).

## Other responses

- `401`: Neplatný nebo zneplatněný API klíč.
- `404`: Firma nenalezena
- `429`: Vyčerpaný limit: bez přihlášení 30 dotazů/den na IP, s účtem měsíční kvóta tarifu (Free 500/měs).

---

[API](https://skmtc.dev/firmastat/apis/firmastat-api.md) · [All operations](https://skmtc.dev/firmastat/apis/firmastat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmastat/apis/firmastat-api/revisions/b1bdf909e040?raw)
