---
title: "Obrat firmy z poslední účetní závěrky"
method: GET
path: "/api/v1/firma/{ico}/finance"
---

# Obrat firmy z poslední účetní závěrky

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

## Request

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

Obrat = „Tržby z prodeje výrobků a služeb" + „Tržby za prodej zboží" z výkazu zisku a ztráty (plný i zkrácený rozsah). Když výkaz ani jednu složku nemá, použije se „Čistý obrat za účetní období". Vrací nejnovější závěrku, ze které obrat jde určit — `rok` říká, za které období je. Strojově ze Sbírky listin (`spolehlivost`: `overeno` = strukturované XML, `odhad` = text PDF). Ukázková (demo) čísla se nevrací nikdy. Firma, kterou ještě nemáme zpracovanou, se zařadí ke zpracování a vrátí `stav: zpracovava-se` — zeptejte se znovu za pár minut.

## Path parameters

- `ico` string, required

## Response `200`

Obrat firmy (nebo stav, proč ho nemáme)

- object
  - `ok` boolean
  - `data` object
    - `obrat` number, nullable: CZK, absolutní hodnota (ne v tisících).
    - `rok` integer, nullable: Účetní období.
    - `typVykazu` 'plny' | 'zkraceny' | 'neznamy' | 'null', nullable
    - `spolehlivost` 'overeno' | 'odhad' | 'null', nullable: `overeno` jen když všechna pole, ze kterých je obrat, přišla ze strukturovaného XML; jinak `odhad`.
    - `zdroj` string, uri, nullable: Dokument ve Sbírce listin, jinak stránka firmy na firmastat.cz.
    - `stav` 'ok' | 'zpracovava-se' | 'nedostupne': `ok` = obrat známe; `zpracovava-se` = závěrky se právě stahují, zkuste to znovu; `nedostupne` = výkaz s tržbami nemáme (nezveřejněn, sken, nebo se teď nedá zařadit).

## Other responses

- `400`: Neplatné IČO
- `401`: Neplatný nebo zneplatněný API klíč.
- `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).
- `502`: Databáze dočasně nedostupná

---

[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)