Skip to main content

​
Understand the pattern

Regardless of what you’re trying to retrieve, every RÚZ integration follows the same drill-down pattern. Once you understand it, the rest of the API becomes much easier to work with. You never get everything in one call. Each step gets you closer to the data you need:
  1. List — call an identifier list endpoint to get a page of IDs matching your criteria.
  2. Fetch — use an ID to get the full record for that entity.
  3. Drill down — the full record contains IDs of related entities. Follow them to go deeper.

​
Understand the hierarchy

Four main entity types make up the register. An Accounting unit is always the starting point. Financial statements and annual reports link from it, and financial reports link from those. Each arrow is a field on the parent containing an array of child IDs. You call the child’s detail endpoint with those IDs to go one level deeper. Dotted lines indicate supporting objects that belong to a parent but are not navigated to via a separate endpoint.
A financial report can belong to both a financial statement and an annual report simultaneously.
To learn more about each entity type, see Data models.

​
See common flows

The examples below demonstrate the drill-down pattern with real requests and responses. Each one shows a complete flow from listing IDs to retrieving the data you need.
Drilling from an accounting unit down to structured financial statements and reports.
1

Find the accounting unit ID

Call the accounting units list with an ico filter to find the entity.
List accounting units by IČO
curl "https://www.registeruz.sk/cruz-public/api/uctovne-jednotky?zmenene-od=2000-01-01&ico=00603481"
Response
{
  "id": [336953],
  "existujeDalsieId": false
}
2

Fetch the accounting unit

Use the ID to get the full record. The response contains idUctovnychZavierok, the IDs of all financial statements filed by this unit.
Get accounting unit by ID
curl "https://www.registeruz.sk/cruz-public/api/uctovna-jednotka?id=336953"
Response
{
  "id": 336953,
  "ico": "00603481",
  "nazovUJ": "Hlavné mesto Slovenskej republiky Bratislava",
  "datumZalozenia": "1991-01-01",
  "idUctovnychZavierok": [340867, 497509, 1100864],
  "idVyrocnychSprav": []
}
3

Fetch a financial statement

Pick a statement ID from idUctovnychZavierok and fetch its detail. The response contains idUctovnychVykazov, the IDs of the individual financial reports within this statement.
Get financial statement by ID
curl "https://www.registeruz.sk/cruz-public/api/uctovna-zavierka?id=340867"
Response
{
  "id": 340867,
  "idUJ": 336953,
  "obdobieOd": "2009-01",
  "obdobieDo": "2009-12",
  "typ": "Riadna",
  "idUctovnychVykazov": [686260, 680247]
}
4

Fetch a financial report

Pick a report ID from idUctovnychVykazov and fetch its detail. The response contains structured table data in obsah.tabulky, a cover page in titulnaStrana, and downloadable attachments in prilohy.
Get financial report by ID
curl "https://www.registeruz.sk/cruz-public/api/uctovny-vykaz?id=686260"
Response
{
  "id": 686260,
  "idUctovnejZavierky": 340867,
  "idSablony": 98,
  "obsah": {
    "titulnaStrana": {
      "ico": "00603481",
      "obdobieOd": "2009-01",
      "obdobieDo": "2009-12",
      "nazovUctovnejJednotky": "Hlavné mesto Slovenskej republiky Bratislava"
    },
    "tabulky": [
      { "nazov": { "sk": "Náklady" }, "data": ["4248919", "17058", "145116521"] },
      { "nazov": { "sk": "Výnosy" }, "data": ["12222937", "425982", "130597430"] }
    ]
  },
  "prilohy": [
    { "id": 214469, "mimeType": "image/tiff", "velkostPrilohy": 203499 }
  ]
}
Row labels for tabulky are defined by the report template at idSablony. Fetch it from Get report template to map row numbers to their Slovak labels.
Drilling from an accounting unit down to annual report attachments.
1

Fetch the accounting unit

The accounting unit response contains idVyrocnychSprav, the IDs of all annual reports filed by this unit.
Get accounting unit by ID
curl "https://www.registeruz.sk/cruz-public/api/uctovna-jednotka?id=635004"
Response
{
  "id": 635004,
  "nazovUJ": "Continental Matador Rubber, s.r.o.",
  "idVyrocnychSprav": [316853, 316854]
}
2

Fetch an annual report

Pick an ID from idVyrocnychSprav and fetch its detail. Download attachments at /domain/financialreport/attachment/{id}.
Get annual report by ID
curl "https://www.registeruz.sk/cruz-public/api/vyrocna-sprava?id=316853"
Response
{
  "id": 316853,
  "nazovUJ": "Continental Matador Rubber, s.r.o.",
  "typ": "Individuálna výročná správa",
  "obdobieOd": "2011-01",
  "obdobieDo": "2011-12",
  "prilohy": [
    {
      "id": 217769,
      "mimeType": "image/tiff",
      "meno": "POD201_4045546120_IR_2011_617_2013_538566.TIF",
      "velkostPrilohy": 296519
    }
  ]
}

​
Next steps

Pagination

How to page through identifier list results.

Syncing data

How to fetch only recently updated records and keep a local copy in sync.

Codelists

Resolve coded fields (legal form, NACE, region, district, etc.) to labels.

API Reference

Every endpoint with parameters, responses, and examples.