ARES (Czech business register) Ekonomicke Subjekty Rzp API
ekonomicke-subjekty-rzp operations
ekonomicke-subjekty-rzp operations
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/ares-gov-cz:ares-gov-cz-ekonomicke-subjekty-rzp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Ares Gov Cz Ekonomicke Subjekty Rzp API
version: '1.4'
description: 'Operations tagged ekonomicke-subjekty-rzp across 2 of this provider''s published API definitions: ares-gov-cz-openapi-original.json, ares-gov-cz-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /ekonomicke-subjekty-v-be/rest
- url: https://ares.gov.cz/ekonomicke-subjekty-v-be/rest
description: Production (the published spec declares the relative server /ekonomicke-subjekty-v-be/rest, resolved against ares.gov.cz where it is served)
security:
- BasicAuth: []
- BearerAuth: []
tags:
- name: ekonomicke-subjekty-rzp
description: ekonomicke-subjekty-rzp operations
paths:
/ekonomicke-subjekty-rzp/{ico}:
get:
description: Vyhledání konkrétního ekonomického subjektu ze zdroje RŽP
operationId: vratEkonomickySubjektRzp
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/EkonomickySubjektRzp'
'400':
description: Chyba vstupu
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'401':
description: Chyba autentizace
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'403':
description: Přístup zamítnut
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'404':
description: Zdroj nenalezen
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'500':
description: Neočekávaná chyba
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
parameters:
- in: path
name: ico
required: true
schema:
maxLength: 32
pattern: ^(ARES_)?\d{8}$
type: string
tags:
- ekonomicke-subjekty-rzp
summary: Vrat ekonomicky subjekt rzp
x-summary-source: derived
servers:
- url: /ekonomicke-subjekty-v-be/rest
/ekonomicke-subjekty-rzp/vyhledat:
post:
description: Vyhledání seznamu ekonomických subjektu ze zdroje RŽP
operationId: vyhledejSeznamEkonomickychSubjektuRzp
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/EkonomickeSubjektyRzpSeznam'
'400':
description: Chyba vstupu
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'401':
description: Chyba autentizace
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'403':
description: Přístup zamítnut
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'404':
description: Zdroj nenalezen
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
'500':
description: Neočekávaná chyba
content:
application/json:
schema:
$ref: '#/components/schemas/Chyba'
parameters: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EkonomickeSubjektyRegistraceFiltr'
tags:
- ekonomicke-subjekty-rzp
summary: Vyhledej seznam ekonomickych subjektu rzp
x-summary-source: derived
servers:
- url: /ekonomicke-subjekty-v-be/rest
components:
schemas:
ZaznamRzp:
type: object
description: Detailní informace o ekonomickém subjektu ze zdroje RŽP
allOf:
- $ref: '#/components/schemas/ZaznamRzpZaklad'
- properties:
souvisejiciSubjekty:
type: array
items:
$ref: '#/components/schemas/AngazovanySubjektRzp'
description: Související subjekty, podílející se na řízení
osobaPodnikatel:
$ref: '#/components/schemas/AngazovanaOsobaRzp'
description: Informace o podnikateli
angazovaneOsoby:
type: array
items:
$ref: '#/components/schemas/AngazovanaOsobaRzp'
description: Seznam osob podílejícíh se na řízení
zivnosti:
type: array
items:
$ref: '#/components/schemas/Zivnost'
description: Seznam živností
ZivnostPreruseni:
type: object
description: Přerušení živnosti
properties:
platnostOd:
format: date
type: string
description: Platnost přerušení živnosti od data
platnostDo:
format: date
type: string
description: Platnost přerušení živnosti do data
Seznam:
type: object
description: Seznam nalezených záznamů - obecný předek.
properties:
pocetCelkem:
format: int32
minimum: 0
type: integer
description: Počet prvků seznamu.
ZivnostBezOZ:
type: object
description: Živnost bez odpovědného zástupce
properties:
platnostOd:
format: date
type: string
description: 'Zahájení vykonávání živnosti bez odpovědného zástupce od data '
platnostDo:
format: date
type: string
description: 'Ukončení vykonávání živnosti bez odpovědného zástupce od data '
ZivnostProvozovnaPozastaveni:
type: object
description: Pozastavení provozovny nebo živnosti
properties:
platnostOd:
format: date
type: string
description: Platnost pozastavení živnosti od data
platnostDo:
format: date
type: string
description: Platnost pozastavení živnosti do data
rozsahPozastaveni:
maxLength: 1024
type: string
description: Popis rozsahu pozastavení živnosti
AngazovanaOsoba:
type: object
description: Osoba v angažmá ekonomického subjektu
properties:
jmeno:
maxLength: 100
type: string
description: Jméno fyzické osoby
prijmeni:
maxLength: 100
type: string
description: Příjmení fyzické osoby
titulPredJmenem:
maxLength: 32
type: string
description: 'Titul před jménem fyzické osoby '
titulZaJmenem:
maxLength: 32
type: string
description: Titul za jménem fyzické osoby
datumNarozeni:
format: date
type: string
description: Datum narození fyzické osoby
AngazovanySubjektRzp:
type: object
description: 'Právnické osoby v angažmá ekonomického subjektu. '
allOf:
- $ref: '#/components/schemas/AngazovanySubjektRzpZaklad'
- properties:
osobyZastupce:
type: array
items:
$ref: '#/components/schemas/AngazovanaOsobaRzp'
description: Seznam zástupců angažovaného subjektu
AngazovanySubjektRzpZaklad:
type: object
description: 'Právnické osoby v angažmá ekonomického subjektu. '
properties:
typAngazma:
maxLength: 64
minLength: 1
type: string
description: 'Typ angažmá osoby u subjektu ve zdroji RŽP (Registr živnostenského podnikání) - kód (ciselnikKod: TypAngazma, zdroj: rzp) '
platnostOd:
format: date
type: string
description: Platnost angažmá subjektu od data
platnostDo:
format: date
type: string
description: Platnost angažmá subjektu do data
ico:
maxLength: 8
minLength: 8
pattern: ^\d{8}$
type: string
description: Ičo angažovaného subjektu
obchodniJmeno:
maxLength: 2000
minLength: 1
type: string
description: obchodní jméno angažovaného subjektu
sidlo:
$ref: '#/components/schemas/AngazovanySubjektAdresa'
description: Adresa sídla angažovaného subjektu
typSubjektu:
maxLength: 64
minLength: 1
type: string
description: 'Typ subjektu - kód (ciselnikKod: TypSubjektu, zdroj: rzp) '
pravniForma:
maxLength: 3
minLength: 3
pattern: ^\d{3}$
type: string
description: 'Právní forma - kód (ciselnikKod: PravniForma, zdroj:com, res) '
kodStatu:
type: string
description: 'Kód státu (ciselnikKod: Stat, zdroj:com) '
InsolvencniRizeni:
type: object
description: Události v rámci insolvenčního řízení
properties:
datumZapisu:
format: date
type: string
description: 'Datum zápisu události '
platnostOd:
format: date
type: string
description: 'Datum zplatnění události '
EkonomickySubjektRzp:
type: object
description: 'Ekonomický subjekt '
properties:
icoId:
maxLength: 32
pattern: ^(ARES_)?\d{8}$
type: string
description: ičo/id ekonomického subjektu
zaznamy:
type: array
items:
$ref: '#/components/schemas/ZaznamRzp'
description: Seznam záznamů daného iča
EkonomickySubjektZaklad:
type: object
description: Základní informace o ekonomickém subjektu - obecný předek
properties:
ico:
maxLength: 8
minLength: 8
pattern: ^\d{8}$
type: string
description: Identifikační číslo osoby - IČO
obchodniJmeno:
maxLength: 2000
minLength: 1
type: string
description: Obchodní jméno ekonomického subjektu
sidlo:
$ref: '#/components/schemas/Adresa'
description: Sídlo ekonomického subjektu
pravniForma:
maxLength: 3
minLength: 3
pattern: ^\d{3}$
type: string
description: 'Právní forma - kód (ciselnikKod: PravniForma, zdroj: res, com) '
pravniFormaRos:
maxLength: 3
minLength: 3
pattern: ^\d{3}$
type: string
description: 'Právní forma ekonomického subjektu - kód (ciselnikKod: PravniFormaRos, zdroj:ros)'
financniUrad:
maxLength: 3
minLength: 3
pattern: ^\d{3}$
type: string
description: 'Správně příslušný finanční úřad - kód (ciselnikKod: FinancniUrad, zdroj:ufo) '
datumVzniku:
format: date
type: string
description: 'Datum vzniku ekonomického subjektu '
datumZaniku:
format: date
type: string
description: Datum zániku ekonomického subjektu
datumAktualizace:
format: date
type: string
description: Datum aktualizace záznamu
dic:
type: string
description: Daňové identifikační číslo ve formátu CZNNNNNNNNNN
Adresa:
type: object
description: 'Adresa - obecný předek '
properties:
kodStatu:
type: string
description: 'Kód státu (ciselnikKod: Stat) '
nazevStatu:
maxLength: 32
type: string
description: Název státu
kodKraje:
maximum: 999
minimum: 0
type: integer
description: Kód kraje
nazevKraje:
maxLength: 32
type: string
description: Název kraje
kodOkresu:
format: int32
maximum: 9999
minimum: 0
type: integer
description: Kód okresu
nazevOkresu:
maxLength: 32
type: string
description: Název okresu
kodObce:
format: int32
maximum: 999999
minimum: 0
type: integer
description: Kód obce
nazevObce:
maxLength: 48
type: string
description: Název obce
kodSpravnihoObvodu:
maximum: 999
minimum: 0
type: integer
description: Kód správního obvodu Prahy
nazevSpravnihoObvodu:
maxLength: 32
type: string
description: 'Název správního obvodu Prahy '
kodMestskehoObvodu:
maximum: 999
minimum: 0
type: integer
description: Kód městského obvodu Prahy
nazevMestskehoObvodu:
maxLength: 32
type: string
description: Název městského obvodu Prahy
kodMestskeCastiObvodu:
format: int32
maximum: 999999
minimum: 0
type: integer
description: Kód městské části statutárního města
kodUlice:
format: int32
maximum: 9999999
minimum: 0
type: integer
description: Kód ulice, veřejného prostranství ze zdroje
nazevMestskeCastiObvodu:
maxLength: 48
type: string
description: 'Název městské části statutárního města '
nazevUlice:
maxLength: 48
type: string
description: 'Název ulice, veřejného prostranství '
cisloDomovni:
maximum: 9999
type: integer
description: Číslo domovní
doplnekAdresy:
maxLength: 1500
type: string
description: Doplňující informace adresního popisu
kodCastiObce:
format: int32
maximum: 999999
minimum: 0
type: integer
description: Kód časti obce
cisloOrientacni:
maximum: 999
type: integer
description: Číslo orientační - číselná část
cisloOrientacniPismeno:
maxLength: 1
type: string
description: Číslo orientační - písmenná část
nazevCastiObce:
maxLength: 48
type: string
description: Název části obce
kodAdresnihoMista:
maximum: 999999999
minimum: 0
type: integer
description: Kód adresního místa
psc:
type: integer
description: Poštovní směrovací číslo adresní pošty
textovaAdresa:
maxLength: 1500
type: string
description: Nestrukturovaná adresa (formátovaná adresa)
cisloDoAdresy:
maxLength: 255
type: string
description: Nestrukturované číslo/a použíté v adrese
standardizaceAdresy:
type: boolean
description: Stav standardizace adresy dle RÚIAN
pscTxt:
maximum: 255
type: string
description: Psč zahraničních nebo nestandardně definovaných čísel
typCisloDomovni:
maximum: 9999
type: integer
description: 'Typ čísla domu - kód (ciselnikKod: TypCislaDomovniho) '
AngazovanaOsobaRzp:
type: object
description: Angažovaná osoba zdroje RŽP
allOf:
- $ref: '#/components/schemas/AngazovanaOsoba'
- properties:
platnostOd:
format: date
type: string
description: Platnost angažmá osoby od data
platnostDo:
format: date
type: string
description: 'Platnost angažmá osoby do data '
statniObcanstvi:
type: string
description: 'Státní občanství osoby - kód (ciselnikKod: Stat, zdroj:com) '
typAngazma:
maxLength: 64
minLength: 1
type: string
description: 'Typ angažmá osoby - kód (ciselnikKod: TypAngazma, zdroj: rzp) '
ProvozovnaZaklad:
type: object
description: Provozovna - obecný předek
properties:
icp:
maxLength: 10
minLength: 10
type: integer
description: identifikační číslo provozovny
sidloProvozovny:
$ref: '#/components/schemas/Adresa'
description: Adresa sídla provozovny
umisteniProvozovny:
maxLength: 254
type: string
description: Umístění provozovny
platnostOd:
format: date
type: string
description: Platnost provozovny od data
platnostDo:
format: date
type: string
description: 'Platnost provozovny do data '
pozastaveniProvozovny:
type: array
items:
$ref: '#/components/schemas/ZivnostProvozovnaPozastaveni'
description: Seznam období pozastavení provozovny
typProvozovny:
maxLength: 1
minLength: 1
pattern: ^\d{1}$
type: string
description: 'Typ provozovny - kód (ciselnikKod: TypProvozovny) '
nazev:
maxLength: 254
type: string
description: Název provozovny
EkonomickeSubjektyRegistraceFiltr:
type: object
description: Filtr pro vyhledání seznamu ekonomických subjektů podle parametru IČO.
allOf:
- $ref: '#/components/schemas/StrankovaniARazeni'
- properties:
ico:
type: array
items:
maxLength: 8
minLength: 8
pattern: ^\d{8}$
type: string
description: Ičo ekonomického subjektu
ZivnostiRzpStav:
type: object
description: Stav živnosti
properties:
pocetAktivnich:
format: int32
minimum: 0
type: integer
description: Celkový počet aktivních živností
pocetZaniklych:
format: int32
minimum: 0
type: integer
description: Celkový počet zaniklých živností
pocetPozastavenych:
format: int32
minimum: 0
type: integer
description: Celkový počet pozastavených živností
pocetPrerusenych:
format: int32
minimum: 0
type: integer
description: Celkový počet přerušených živností
pocetCelkem:
format: int32
minimum: 0
type: integer
description: Celkový počet živností
ZaznamRzpZaklad:
type: object
description: Detailní informace o ekonomickém subjektu ze zdroje RŽP
allOf:
- $ref: '#/components/schemas/EkonomickySubjektZaklad'
- properties:
insolvencniRizeni:
$ref: '#/components/schemas/InsolvencniRizeni'
description: Události v rámci insolvenčního řízení
datumDoruceniVypisu:
format: date
type: string
description: 'Datum doručení prvního výpisu sloužícího jako průkaz živnostenského podnikání, '
adresySubjektu:
type: array
items:
$ref: '#/components/schemas/EkonomickySubjektRzpAdresa'
description: 'Seznam adres '
typSubjektu:
maxLength: 64
minLength: 1
type: string
description: 'Typ subjektu - kód (ciselnikKod: TypSubjektu, zdroj: rzp) '
zivnostenskyUrad:
pattern: ^\d{6}$
type: string
description: 'Živnostenský úřad – kód (ciselnikKod: ZivnostenskyUrad, zdroj: rzp)'
organizacniSlozka:
maxLength: 2000
minLength: 1
type: string
description: Název organizační složky
zivnostiStav:
$ref: '#/components/schemas/ZivnostiRzpStav'
description: 'Stav živnosti - kód (ciselnikKod: StavZivnosti) '
datumZapisuVr:
format: date
type: string
description: 'Datum zápisu do Obchodního nebo podobného rejstříku '
provozovnyStav:
$ref: '#/components/schemas/ProvozovnyRzpStav'
description: 'Stav provozovny - kód (ciselnikKod: StavProvozovny) '
primarniZaznam:
type: boolean
description: 'Identifikace primárního záznamu pozn.: U multiplicitních registrací je pouze jedna registrace primární'
kodStatu:
type: string
description: 'Kód státu (ciselnikKod: Stat, zdroj:com) '
KodChybyEnum:
description: Chybové kódy.
type: string
enum:
- OBECNA_CHYBA
- CHYBA_VSTUPU
- NENALEZENO
- NENI_IMPLEMENTOVANO
- NEPRIHLASENY_UZIVATEL
- NENI_OPRAVNENI
ZivnostZaklad:
type: object
description: Živnosti, které ekonomický subjekt provozuje nebo provozoval - obecný předek
properties:
datumVzniku:
format: date
type: string
description: 'Datum vzniku živnosti '
datumZaniku:
format: date
type: string
description: 'Datum zániku živnosti '
platnostDo:
format: date
type: string
description: Platnost živnosti do data
predmetPodnikani:
maxLength: 750
minLength: 5
type: string
description: Předmět podnikáni živnosti
pozastaveniZivnosti:
type: array
items:
$ref: '#/components/schemas/ZivnostProvozovnaPozastaveni'
description: Seznam období pozastavení živnosti
podminkyProvozovaniZivnosti:
type: array
items:
$ref: '#/components/schemas/ZivnostPodminky'
description: Podmínky provozování živnosti
preruseniZivnosti:
type: array
items:
$ref: '#/components/schemas/ZivnostPreruseni'
description: 'Seznam období přerušení živnosti '
zivnostBezOz:
type: array
items:
$ref: '#/components/schemas/ZivnostBezOZ'
description: Seznam období provozování živnosti bez odpovědného zástupce
datumAktualizace:
format: date
type: string
description: Datum aktualizace záznamu
druhZivnosti:
maxLength: 1
minLength: 1
type: string
description: 'Druh živnosti - kód (ciselnikKod: DruhZivnosti) '
ProvozovnyRzpStav:
type: object
description: Stav provozovny
properties:
pocetCelkem:
format: int32
minimum: 0
type: integer
description: Celkový počet provozoven
pocetZaniklych:
format: int32
minimum: 0
type: integer
description: Celkový počet zaniklých provozoven
pocetAktivnich:
format: int32
minimum: 0
type: integer
description: Celkový počet aktivnich provozoven
pocetPozastavenych:
format: int32
minimum: 0
type: integer
description: Celkový počet zaniklých provozoven
Zivnost:
type: object
description: Živnosti, které ekonomický subjekt provozuje nebo provozoval ve zdroji RŽP
allOf:
- $ref: '#/components/schemas/ZivnostZaklad'
- properties:
oboryCinnosti:
type: array
items:
$ref: '#/components/schemas/ZivnostOborCinnosti'
description: Seznam oborů činnosti živnosti
odpovedniZastupci:
type: array
items:
$ref: '#/components/schemas/AngazovanaOsobaRzp'
description: Odpovědní zástupci za živnost
provozovny:
type: array
items:
$ref: '#/components/schemas/Provozovna'
description: Provozovny
Chyba:
type: object
properties:
kod:
$ref: '#/components/schemas/KodChybyEnum'
popis:
type: string
description: Popis chyby
subKod:
type: string
description: Subkod chyby
EkonomickeSubjektyRzpSeznam:
type: object
description: Seznam ekonomických subjektů ze zdroje RŽP
allOf:
- $ref: '#/components/schemas/Seznam'
- properties:
ekonomickeSubjekty:
type: array
items:
$ref: '#/components/schemas/EkonomickySubjektRzp'
description: 'Seznam ekonomických subjektů zdroje RŽP '
Provozovna:
type: object
description: Provozovna
allOf:
- $ref: '#/components/schemas/ProvozovnaZaklad'
- properties:
oboryCinnosti:
type: array
items:
$ref: '#/components/schemas/ZivnostOborCinnosti'
description: Seznam oborů činnosti živnosti
AngazovanySubjektAdresa:
type: object
description: 'Adresa '
allOf:
- $ref: '#/components/schemas/Adresa'
- properties:
platnostOd:
format: date
type: string
description: Platnost adresy od data
platnostDo:
format: date
type: string
description: Platnost adresy do data
EkonomickySubjektRzpAdresa:
type: object
description: Vazební tabulka adres
allOf:
- $ref: '#/components/schemas/Adresa'
- properties:
platnostOd:
format: date
type: string
description: Platnost adresy od data
platnostDo:
format: date
type: string
description: 'Platnost adresy do data '
typAdresy:
maxLength: 64
minLength: 1
type: string
description: 'Typ adresy - kód (ciselnikKod: TypAdresy, zdroj: rzp) '
StrankovaniARazeni:
type: object
description: 'Předek pro všechny seznamy obsahující stránkování a řazení. Defaultní parametry pro všechny aplikace s komplexním filtrem: [+/-]icoiD [+/-]obchodniJmeno [+/-]nazevObce '
properties:
start:
format: int32
minimum: 0
type: integer
description: Offset pro stránkování (poloha prvního vráceného prvku).
pocet:
format: int32
minimum: 0
type: integer
description: Počet prvků k výstupu.
razeni:
type: array
items:
type: string
description: Seznam názvů definujících řazení výstupu.
ZivnostOborCinnosti:
type: object
description: Živnost - obor činnosti
properties:
platnostOd:
format: date
type: string
description: Platnost záznamu od data
platnostDo:
format: date
type: string
description: Platnost záznamu do data
oborNazev:
maxLength: 750
minLength: 5
type: string
description: Název oboru
ZivnostPodminky:
type: object
description: Podmínky pro vykonávání živnosti
properties:
platnostOd:
format: date
type: string
description: Platnost podmínky od data
platnostDo:
format: date
type: string
description: Platnost podmínky do data
podminka:
type: string
description: Text podmínky provozování živnosti
securitySchemes:
BasicAuth:
type: http
scheme: basic
BearerAuth:
type: http
scheme: bearer
x-refined-from:
- ares-gov-cz-openapi-original.json
- ares-gov-cz-openapi.yml