> ## Documentation Index
> Fetch the complete documentation index at: https://slovakapi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Use the RÚZ API to retrieve financial statements, reports, and annual reports for any Slovak accounting unit.

***

## What is RÚZ?

The **RÚZ API** is the public REST API for Slovakia's register of financial statements. It exposes the same data as [registeruz.sk](https://www.registeruz.sk) in JSON — accounting units, financial statements, financial reports, and annual reports — updated throughout the day as records are published.

***

## When to use RÚZ

Use RÚZ when you need to:

* retrieve **financial statements** or **annual reports** for a specific organization
* access structured **financial report data** including table contents and attachments
* build a pipeline that stays in sync with newly published statements
* verify financial filings or enrich company data with accounting information

<Tip>
  RÚZ contains financial data only. For general company information — legal form, registered address, statutory bodies, shareholders — use the [RPO API](/rpo/getting-started/overview) instead.
</Tip>

***

## API endpoints

RÚZ has three types of endpoints:

| Type                 | What it does                                                                    |
| -------------------- | ------------------------------------------------------------------------------- |
| **Identifier lists** | Returns paginated arrays of IDs filtered by `zmenene-od` (changed since).       |
| **Entity details**   | Returns the full record for one entity by `id`.                                 |
| **Codelists**        | Returns reference data — legal forms, NACE, regions, districts, municipalities. |

## How to start

For most integrations, the fastest path is to look up an accounting unit by IČO, then follow the links to its statements and reports.

```mermaid placement="top-right" theme={null}
flowchart LR
  A[Get the unit ID] --> B[Fetch unit detail] --> C[Fetch financial statements] --> D[Fetch financial reports]
```

<Steps>
  <Step title="Get the accounting unit ID">
    Call the accounting units list with a `zmenene-od` date and an `ico` filter.

    ```bash Request theme={null}
    curl "https://www.registeruz.sk/cruz-public/api/uctovne-jednotky?zmenene-od=2000-01-01&ico=00603481"
    ```

    ```json Response theme={null}
    {
      "id": [336953],
      "existujeDalsieId": false
    }
    ```
  </Step>

  <Step title="Fetch the accounting unit detail">
    Use the ID to get the full record — including links to all its statements and annual reports.

    ```bash Request theme={null}
    curl "https://www.registeruz.sk/cruz-public/api/uctovna-jednotka?id=336953"
    ```

    ```json Response theme={null}
    {
      "id": 336953,
      "ico": "00603481",
      "nazovUJ": "Hlavné mesto Slovenskej republiky Bratislava",
      "datumZalozenia": "1991-01-01",
      "idUctovnychZavierok": [340867, 497509, 1100864],
      "idVyrocnychSprav": []
    }
    ```

    `idUctovnychZavierok` is your entry point into this unit's financial statements.
  </Step>

  <Step title="Fetch a financial statement">
    The statement detail links to its individual financial reports.

    ```bash Request theme={null}
    curl "https://www.registeruz.sk/cruz-public/api/uctovna-zavierka?id=340867"
    ```

    ```json Response theme={null}
    {
      "id": 340867,
      "idUJ": 336953,
      "obdobieOd": "2009-01",
      "obdobieDo": "2009-12",
      "typ": "Riadna",
      "idUctovnychVykazov": [686260, 680247]
    }
    ```
  </Step>

  <Step title="Fetch a financial report">
    The report contains structured table data (`tabulky`), a cover page (`titulnaStrana`), and downloadable attachments (`prilohy`).

    ```bash Request theme={null}
    curl "https://www.registeruz.sk/cruz-public/api/uctovny-vykaz?id=686260"
    ```
  </Step>
</Steps>

***

## Considerations

* All dates are `YYYY-MM-DD`. Report periods use `YYYY-MM`.
* Fields with no value are omitted — a missing key means no value.
* Categorical values are returned as codes. Resolve them with the [Codelists](/ruz/concepts/codelists).
* The current API version is returned in the `X-API-Version` response header.
* Invalid or missing parameters return `400`. An unknown `id` returns `404`.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Identifier lists" icon="list" href="/ruz/api-reference/identifier-lists/list-accounting-units">
    All list endpoints, parameters, and pagination for each entity type.
  </Card>

  <Card title="Entity details" icon="file-text" href="/ruz/api-reference/entity-details/get-accounting-unit">
    Full field reference for accounting units, statements, reports, and annual reports.
  </Card>

  <Card title="Data models" icon="layers" href="/ruz/concepts/data-models">
    How units, statements, reports, and annual reports relate to each other.
  </Card>

  <Card title="Codelists" icon="book-open" href="/ruz/concepts/codelists">
    Legal forms, NACE, ownership types, regions, districts, and municipalities.
  </Card>
</CardGroup>