Volby do zastupitelstev obcí – XML
06.10.2026 – verze 1.1
Základní informace
XML se dynamicky generují z aktuálně zpracovaných výsledků voleb z jednotlivých okrskových volebních komisí. Systém prezentace využívá webcache, která omezuje dostupnost aktualizovaných XML dat na dobu 60 sekund (pokud není dále řečeno jinak).
K XML souborům se lze dostat buď přes vyhrazený server pro hromadné sdělovací prostředky (omezení na zadané IP adresy) nebo přímo z volby.cz (veřejně dostupné všem – projekt Otevřená data).
Pro volby do zastupitelstev obcí jsou k dispozici 4 typy XML souborů (průběžné i konečné výsledky):
- Celkové výsledky za ČR
- Výsledky za okresy a obce
- Výsledky za zastupitelstvo obce
- Výsledky za volební okrsky (dávky dat) - bude tvořeno od voleb v říjnu 2018
- (nové) Výsledky za obce (dávky dat) - bude tvořeno od voleb v říjnu 2026
Podrobnější údaje o kandidátech je možné získat z registru, který je zveřejňovaný jako XML soubor na volby.gov.cz v sekci otevřená data.
Poznámka: proti roku 2022 došlo k následujícím změnám
1. doplnění informace o počtu využitých voličských průkazů (od roku 2027)
2. doplnění informace o počtu hlasovacích lístků, které jsou platným hlasem voliče
3. výsledky za zastupitelstva obcí (dávky dat)
Kontaktní osoba k obsahu XML: Zdeňka Burešová: e-mail: zdenka.buresova@csu.gov.cz
Změny v dokumentu:
· 06.10.2026: oprava url adres (chybějící podadresáře)
1. Výsledky za ČR
XML soubor obsahuje průběžnou informaci za celou ČR: volební účast, zpracované volební okrsky a počty zvolených zastupitelů podle jednotlivých volebních stran. Informace bude prezentována zvlášť pro obecní a městská zastupitelstva a zastupitelstva městské části nebo městského obvodu.
Doba aktualizace: 60 sekund
http://volby.gov.cz/appdata/kv2026/20261009/odata/vysledky.xml (aktuální volby)
http://volby.gov.cz/appdata/kv2026/dddddddd/odata/vysledky.xml
· dddddddd je datum prvního dne voleb ve formátu RRRRMMDD
xsd: kv_vysledky.xsd
2. Výsledky za okresy a obce
XML soubor obsahuje Informace o výsledku voleb v obcích ve vybraném okresu: za každou obec v okresu volební účast a zvolení zastupitelé. Číslo okresu bude předáváno jako parametr nuts (čísla okresů lze získat z prezentačního systému voleb volby.gov.cz). Pokud v některém zastupitelstvu obce nejsou ještě spočítány výsledky (tj. chybí data za některý z volebních okrsků), vrátí se průběžný stav bez rozdělených mandátů. Při zadáni chybného čísla okresu či jeho nezadání se vrátí XML s chybou. Pro stažení informace o všech obcích v ČR je nutné stáhnout XML za všechny okresy ČR. Celkem se může jednat až o 10 MB dat.
Pro dekódování seznamu zastupitelstev obcí a jejich územním zařazení se doporučuje využít registr KVRZCOCO, které je zveřejňován na webu spolu s XML soubory.
Doba aktualizace: 60 sekund.
http://volby.gov.cz/appdata/kv2026/20261009/odata/okresy/vysledky_obce_okres_CZXXXX.xml
http://volby.gov.cz/appdata/kv2026/dddddddd/odata/okresy/vysledky_obce_okres_CZXXXX.xml
· dddddddd je datum prvního dne voleb ve formátu RRRRMMDD
· CZXXXX je kód okresu dle číselníku NUTS
xsd: kv_vysledky_obce_okres.xsd
příklady kódu okresu:
· CZ0100: Praha
· CZ0201: Benešov
· CZ0642: Brno-město
· CZ0806: Ostrava-město
Úplný seznam je v sekci opendata na volby.gov.cz
3. Výsledky za zastupitelstvo obce
XML soubor obsahuje informace o výsledku voleb v určitém zastupitelstvu obce: volební účast a zvolení zastupitelé. Číslo zastupitelstva obce je součástí jména XML souboru (čísla zastupitelstva obce lze získat z prezentačního systému voleb volby.gov.cz nebo registr KVRZCOCO). Pokud pro zastupitelstvo obce nejsou ještě spočítány výsledky (tj. chybí data za některý z volebních okrsků), vrátí se průběžný stav bez rozdělených mandátů.
Doba aktualizace: 60 sekund.
https://volby.gov.cz/appdata/kv2026/20261009/odata/zastup/vysledky_obec_xxxxxx.xml
https://volby.gov.cz/appdata/kv2026/dddddddd/odata/zastup/vysledky_obec_xxxxxx.xml
· dddddddd je datum prvního dne voleb ve formátu RRRRMMDD (pro podzim 2026 je 20261009)
· xxxxxx = číslo obce dle registru zastupitelstev (KODZASTUP)
xsd: kv_vysledky_obec.xsd
4. Výsledky za volební okrsky (od voleb v říjnu 2018)
XML soubor obsahuje informaci o počtu voličů, hlasů celkem a hlasů pro jednotlivé kandidátní listiny za jednotlivé volební okrsky. Na rozdíl od ostatních XML dat, se nejedná o stavový soubor, který by vracel vždy kompletní údaje za všechny dosud zpracované okrsky. Ke stažení budou k dispozici přírůstková data za nově zpracované okrsky od poslední dávky – předpokládaný interval vytváření dávek je 5 minut. Informace je předávána za zadané kolo volby (parametr volání – součást url).
Celkovou velikost přenášených XML dat (za všechny dávky) odhadujeme na cca 10 MB.
Doba aktualizace: 5 minut
https://volby.gov.cz/appdata/kv2026/20261009/odata/okrsky/vysledky_okrsky_NNNNN.xml
https://volby.gov.cz/appdata/kv2026/dddddddd/odata/okrsky/vysledky_okrsky_NNNNN.xml
· dddddddd je datum prvního dne voleb ve formátu RRRRMMDD (pro podzim 2026 je 20261009)
· NNNNN je číslo dávky (vedoucí nuly, např. 00001)
Poznámky:
· identifikace okrsku: CIS_OBEC, CIS_OKRSEK, OZNAC_TYPU
o v části volebních okrsků se volí do zastupitelstva obce i do zastupitelstva městské části (obvodu) – např. Praha, Brno, Plzeň, Ostrava, …
o OZNAC_TYPU = OBEC nebo MCMO
· pokud není parametr datumvoleb zadán, vrátí se data z posledních zpracovávaných voleb
· pokud není parametr davka zadán, vrátí se poslední dávka, která je k dispozici
· pro každé kolo se dávky číslují od 1
· pokud nebude v daném pětiminutovém intervalu zpracován žádný okrsek, nebude se dávka vytvářet
· je potřeba počítat s tím, že data za okrsek mohou být zaslána opakovaně a mohou tak být odlišná od předchozí verze (lze rozlišit přes vyšší číslo PORADI_ZPRAC)
o dávky je tak potřeba zpracovávat v pořadí, ve kterém vznikly, resp. do zpracování zahrnout okrsek pouze jednou, právě ten s nejvyšším číslem PORADI_ZPRAC
· v době špičky zpracování může být zpracováno 300 až 800 okrsků za 5 minut
· na začátku a konci zpracování může dávka obsahovat jen jednotky okrsků
Kódy chyb:
10: číslo dávky neexistuje – není ještě vytvořena (před začátkem zpracování)
9999: jiná chyba
http chyba 404 – neexistuje soubor s danou dávkou (dávka ještě nebyla zpracována)
xsd: kv_vysledky_okrsky.xsd
5. Výsledky za obce – dávky (od voleb v říjnu 2026)
XML soubor obsahuje informaci o počtu voličů, hlasů celkem a hlasů pro jednotlivé kandidátní listiny za zastupitelstva obcí, kde se od minulé dávky změnily výsledky, příp. došlo k přidělení mandátů – zvolení zastupitelů. Bude tak možné stahovat menší množství dat, než stažení všech okresních XML (obce za vybraný okres).
Předpokládaný interval dávek je 5 minut, stejně jako u dávek za volební okrsky.
Čísla dávek budou odpovídat dávkám za volební okrsky – přírůstky se budou generovat ze seznamu nově zpracovaných okrsků.
Doba aktualizace: 5 minut
https://volby.gov.cz/appdata/kv2026/20261009/odata/obce_d/vysledky_obce_NNNNN.xml
https://volby.gov.cz/appdata/kv2026/dddddddd/odata/obce_d/vysledky_obce_NNNNN.xml
· dddddddd je datum prvního dne voleb ve formátu RRRRMMDD (pro podzim 2026 je 20261009)
· NNNNN je číslo dávky (vedoucí nuly, např. 00001)
· dávka obsahuje stejné záznamy OBEC jako je v XML se všemi obcemi daného okresu
Kódy chyb:
10: číslo dávky neexistuje – není ještě vytvořena (před začátkem zpracování)
9999: jiná chyba
http chyba 404 – neexistuje soubor s danou dávkou (dávka ještě nebyla zpracována)
xsd: kv_vysledky_obce.xsd
