ARES (Czech business register) Ekonomicke Subjekty Rcns API

ekonomicke-subjekty-rcns operations

GitHub OpenAPI

Operations 2

GET /ekonomicke-subjekty-rcns/{ico} Vrat ekonomicky subjekt rcns #
POST /ekonomicke-subjekty-rcns/vyhledat Vyhledej seznam ekonomickych subjektu rcns #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ares-gov-cz:ares-gov-cz-ekonomicke-subjekty-rcns-api"
All apis
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.

Get an API 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 Specification

ares-gov-cz-ekonomicke-subjekty-rcns-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Ares Gov Cz Ekonomicke Subjekty Rcns API
  version: '1.4'
  description: 'Operations tagged ekonomicke-subjekty-rcns 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-rcns
  description: ekonomicke-subjekty-rcns operations
paths:
  /ekonomicke-subjekty-rcns/{ico}:
    get:
      description: Vyhledání konkrétního ekonomického subjektu ze zdroje RCNS
      operationId: vratEkonomickySubjektRcns
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EkonomickySubjektRcns'
        '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-rcns
      summary: Vrat ekonomicky subjekt rcns
      x-summary-source: derived
    servers:
    - url: /ekonomicke-subjekty-v-be/rest
  /ekonomicke-subjekty-rcns/vyhledat:
    post:
      description: Vyhledání seznamu ekonomických subjektu ze zdroje RCNS
      operationId: vyhledejSeznamEkonomickychSubjektuRcns
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EkonomickeSubjektyRcnsSeznam'
        '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-rcns
      summary: Vyhledej seznam ekonomickych subjektu rcns
      x-summary-source: derived
    servers:
    - url: /ekonomicke-subjekty-v-be/rest
components:
  schemas:
    AngazmaRcns:
      type: object
      description: Angažmá
      properties:
        osobaPravnicka:
          $ref: '#/components/schemas/AngazovanySubjektRcns'
          description: Právnická osoba
        osobaFyzicka:
          $ref: '#/components/schemas/AngazovanaOsobaRcns'
          description: Fyzická osoba
    SubjektCirkev:
      type: object
      description: Církev
      allOf:
      - $ref: '#/components/schemas/SubjektCirkevZaklad'
      - properties:
          organy:
            type: array
            items:
              $ref: '#/components/schemas/AngazovanySubjektRcns'
              description: 'Struktura s informacemi o právnických osobách, které mají právo jednat jménem daného svazu církví na území ČR. '
    SubjektPravnickaOsobaZaklad:
      type: object
      description: 'Právnická osoba církve - základ - obecný předek '
      properties:
        icoZrizovatel:
          maxLength: 8
          minLength: 8
          pattern: ^\d{8}$
          type: string
          description: 'IČO zřizovatele právnické osoby. '
        icoNastupce:
          maxLength: 8
          minLength: 8
          pattern: ^\d{8}$
          type: string
          description: 'IČO nástupce zrušené právnické osoby. '
        zpusobZruseniRegistrace:
          type: integer
          description: 'Způsob zrušení registrace – kód (ciselnikKod: ZpusobZruseni, zdroj: rcns)'
    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.
    ZaznamRcns:
      type: object
      description: Detailní informace o ekonomickém subjektu ze zdroje RCNS
      allOf:
      - $ref: '#/components/schemas/ZaznamRcnsZaklad'
      - properties:
          statutarniOrgan:
            $ref: '#/components/schemas/StatutatniOrganRcns'
            description: Statutární orgány církve
          likvidatori:
            type: array
            items:
              $ref: '#/components/schemas/AngazmaRcns'
              description: Struktura s údaji o likvidátorech.
          konkurzniSpravci:
            type: array
            items:
              $ref: '#/components/schemas/AngazmaRcns'
              description: 'Struktura s údaji o správcích konkurzní podstaty. '
          opatrovnici:
            type: array
            items:
              $ref: '#/components/schemas/AngazmaRcns'
              description: Opatrovníci
    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
    PravoZvlastni:
      type: object
      description: Oprávnění k výkonu zvláštních práv církve
      properties:
        platnostOd:
          format: date
          type: string
          description: 'Začátek platnosti zvláštního práva subjektu '
        platnostDo:
          format: date
          type: string
          description: Konec platnosti zvláštního práva subjektu
        kodPravo:
          type: integer
          description: 'Oprávnění pro výkon církve - kód (ciselnikKod: Pravo, zdroj: rcns) '
    AngazovanySubjektRcns:
      type: object
      description: Angažovaný subjekt
      allOf:
      - $ref: '#/components/schemas/AngazovanySubjektRcnsZaklad'
      - properties:
          statutarniOrgany:
            type: array
            items:
              $ref: '#/components/schemas/AngazovanaOsobaRcns'
              description: Statutární orgány
    EkonomickySubjektRcns:
      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/ZaznamRcns'
            description: Seznam záznamů daného iča
    StatutatniOrganRcns:
      type: object
      description: Stautární orgány církve
      properties:
        subjektCirkev:
          $ref: '#/components/schemas/SubjektCirkev'
          description: Struktura s údaji sledovanými u subjektu typu církev
        subjektSvazCirkvi:
          $ref: '#/components/schemas/SubjektSvazCirkvi'
          description: Struktura s údaji sledovanými u subjektu typu svaz církví
        subjektPravnickaOsoba:
          $ref: '#/components/schemas/SubjektPravnickaOsoba'
          description: Struktura s údaji sledovanými u subjektu typu právnická osoba dříve církevní právnická osoba.
    ZaznamRcnsZaklad:
      type: object
      description: 'Základní informace o ekonomickém subjektu - obecný předek zdroje RCNS '
      allOf:
      - $ref: '#/components/schemas/EkonomickySubjektZaklad'
      - properties:
          typSubjektu:
            maxLength: 64
            minLength: 1
            type: string
            description: 'Typ subjektu - kód (ciselnikKod: TypSubjektuRcns) '
          stat:
            type: string
            description: Stát
          primarniZaznam:
            type: boolean
            description: Primární záznam
          registrace:
            $ref: '#/components/schemas/RegistraceRcns'
            description: Registrace
          zpusobJednani:
            type: array
            items:
              $ref: '#/components/schemas/ZpusobJednani'
              description: Způsob jednání
          adresySubjektu:
            type: array
            items:
              $ref: '#/components/schemas/AdresaRcns'
              description: Seznam adres subjektu
          zdrojId:
            maxLength: 100
            type: string
            description: Identifikátor záznamu ve zdrojovém registru.
          platnostOd:
            format: date
            type: string
            description: Platnost subjekt v registru od
    AngazovanaOsobaRcns:
      type: object
      description: 'Název vykonávané statutární(církevní) funkce '
      allOf:
      - $ref: '#/components/schemas/AngazovanaOsoba'
      - properties:
          platnostOd:
            format: date
            type: string
            description: Platnost angažované osoby od data
          platnostDo:
            format: date
            type: string
            description: Platnost angažované osoby od data
          poznamka:
            maxLength: 100
            type: string
            description: Dodatečná informace jako 'funkce neobsazena'
          typAngazma:
            maxLength: 64
            minLength: 1
            type: string
            description: 'Typ angažmá osoby  - kód (ciselnikKod: TypAngazma, zdroj: rcns) '
          nazevOrganu:
            maxLength: 100
            type: string
            description: Název orgánu
          kodStatu:
            type: string
            description: 'Kód státu  (ciselnikKod: Stat) '
          pravniForma:
            maxLength: 3
            minLength: 3
            pattern: ^\d{3}$
            type: string
            description: 'Právní forma - kód (ciselnikKod: PravniForma) '
    EkonomickeSubjektyRcnsSeznam:
      type: object
      description: Seznam ekonomických subjektů ze zdroje RCNS
      allOf:
      - $ref: '#/components/schemas/Seznam'
      - properties:
          ekonomickeSubjekty:
            type: array
            items:
              $ref: '#/components/schemas/EkonomickySubjektRcns'
              description: 'Seznam ekonomických subjektů zdroje RŽP '
    ClenSvazu:
      type: object
      description: Člen svazu církví
      properties:
        ico:
          maxLength: 8
          minLength: 8
          pattern: ^\d{8}$
          type: string
          description: IČO člana svazu
        platnostOd:
          format: date
          type: string
          description: 'Platnost členství od data '
        platnostDo:
          format: date
          type: string
          description: Platnost členství do data
    SubjektSvazCirkvi:
      type: object
      description: Svaz církví
      allOf:
      - $ref: '#/components/schemas/SubjektSvazCirkviZaklad'
      - properties:
          organy:
            type: array
            items:
              $ref: '#/components/schemas/AngazovanySubjektRcns'
              description: Struktura s údaji sledovanými u subjektu typu svaz církví
    ZpusobJednani:
      type: object
      description: tabulka způsobů jednání subjektu
      properties:
        popis:
          type: string
          description: popis způsobu jednání
        platnostOd:
          format: date
          type: string
          description: Počátek platnosti způsobu jednání dle popisu
        platnostDo:
          format: date
          type: string
          description: 'Konec platnosti způsobu jednání dle popisu '
    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) '
    SubjektSvazCirkviZaklad:
      type: object
      description: Svaz církví - základ - obecný předek
      properties:
        clenoveSvazu:
          type: array
          items:
            $ref: '#/components/schemas/ClenSvazu'
            description: 'Struktura s informacemi o členech daného svazu církví. '
        icoNastupce:
          maxLength: 8
          minLength: 8
          pattern: ^\d{8}$
          type: string
          description: 'IČO nástupce zrušené právnické osoby. '
    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
    AdresaRcns:
      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
          typAdresy:
            maxLength: 64
            minLength: 1
            type: string
            description: 'Typ adresy  - kód (ciselnikKod: TypAdresy, zdroj: rcns) '
    KodChybyEnum:
      description: Chybové kódy.
      type: string
      enum:
      - OBECNA_CHYBA
      - CHYBA_VSTUPU
      - NENALEZENO
      - NENI_IMPLEMENTOVANO
      - NEPRIHLASENY_UZIVATEL
      - NENI_OPRAVNENI
    Chyba:
      type: object
      properties:
        kod:
          $ref: '#/components/schemas/KodChybyEnum'
        popis:
          type: string
          description: Popis chyby
        subKod:
          type: string
          description: Subkod chyby
    AngazovanySubjektRcnsZaklad:
      type: object
      description: Angažovaný subjekt
      properties:
        ico:
          maxLength: 8
          minLength: 8
          pattern: ^\d{8}$
          type: string
          description: IČO
        dic:
          type: string
          description: DIČ
        platnostOd:
          format: date
          type: string
          description: Platnost záznamu od data
        platnostDo:
          format: date
          type: string
          description: Platnost záznamu do data
        sidlo:
          $ref: '#/components/schemas/AdresaRcns'
          description: Adresa sídla
        obchodniJmeno:
          maxLength: 2000
          minLength: 1
          type: string
          description: Obchodní jméno subjektu
        kodStatu:
          type: string
          description: 'Kód státu  (ciselnikKod: Stat) '
        pravniForma:
          maxLength: 3
          minLength: 3
          pattern: ^\d{3}$
          type: string
          description: 'Právní forma - kód (ciselnikKod: PravniForma) '
    RegistraceRcns:
      type: object
      description: Informace o registraci církve
      properties:
        cisloRegistrace:
          maxLength: 30
          type: string
          description: Pro subjekt typu církev a svaz církví je zde uvedeno registrační číslo pod kterým byl daný subjekt zaregistrován na MK. Pro subjekty typu právnická osoba je zde uvedeno evidenční číslo pod kterým byl daný subjekt zaevidován na MK.
        cisloZruseniRegistrace:
          maxLength: 30
          type: string
          description: Datum zrušení registrace, evidence subjektu na MK
        datumLikvidace:
          format: date
          type: string
          description: Datum vyhlášení likvidace subjektu
        datumKonkurzu:
          format: date
          type: string
          description: Datum vyhlášení konkurzu subjektu
        datumOpatrovnik:
          format: date
          type: string
          description: Datum jmenování opatrovníka
        datumZruseniRegistrace:
          format: date
          type: string
          description: Datum zrušení registrace, evidence subjektu na MK
    SubjektCirkevZaklad:
      type: object
      description: 'Církev - základ - obecný předek '
      properties:
        datumRegistracePrav:
          format: date
          type: string
          description: Datum registrace práv dané církvi.
        cisloRegistracePrav:
          maxLength: 30
          type: string
          description: Číslo registrace práv dané církvi.
        icoNastupce:
          maxLength: 8
          minLength: 8
          pattern: ^\d{8}$
          type: string
          description: 'IČO nástupce zrušené právnické osoby. '
        datumZruseniRegistracePrav:
          format: date
          type: string
          description: Datum zrušení registrace práv dané církvi.
        pravoZvlastni:
          type: array
          items:
            $ref: '#/components/schemas/PravoZvlastni'
            description: Seznam informací o zvláštním právu církve.
        cisloZruseniRegistracePrav:
          maxLength: 30
          type: string
          description: Číslo zrušení registrace práv dané církvi.
    SubjektPravnickaOsoba:
      type: object
      description: Právnická osoba církve
      allOf:
      - $ref: '#/components/schemas/SubjektPravnickaOsobaZaklad'
      - properties:
          organy:
            type: array
            items:
              $ref: '#/components/schemas/AngazovanaOsobaRcns'
              description: Struktura s informacemi o statutárních orgánech (členech orgánu) dané právnické osoby.
    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.
  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