---
title: "Dávkový stav DPH (až 100 IČO)"
method: POST
path: "/api/v1/firmy/dph"
---

# Dávkový stav DPH (až 100 IČO)

`POST /api/v1/firmy/dph`

## Request

- Base URL: `https://firmastat.cz`
- URL: `https://firmastat.cz/api/v1/firmy/dph`
- Auth: one of:
  - none
  - HTTP bearer

Čte se JEN z už ověřených dat — IČO, ke kterým stav nemáme, se vrátí v `neovereno` s `dph: null` a zařadí se na dohledání. Účtuje se objemem: 1 jednotka kvóty za každé (deduplikované) IČO.

## Request body

- object
  - `ico` string[], required

## Response `200`

Stav DPH pro poslaná IČO

- object
  - `ok` boolean
  - `data` object
    - `pocet` integer
    - `neovereno` string[]
    - `firmy` object[]
      - `ico` string
      - `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

- `400`: Chybí IČO, neplatné IČO, nebo víc než 100
- `401`: Neplatný nebo zneplatněný API klíč.
- `413`: Tělo požadavku nad 16 kB
- `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)