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

# List report templates

> Returns all financial report templates as a single list.

Returns every template in the register in a single call, with no filters or pagination. Templates define the row structure of financial report table data and are referenced via `idSablony` on each financial report.

<Info>
  Templates are never deleted, so this list only ever grows. Fetch it once and cache it.
</Info>

***

## Common patterns

<AccordionGroup>
  <Accordion title="Build a local template lookup">
    Since templates are stable and never deleted, a common pattern is to fetch them all upfront and index by `id`. This way you can resolve row labels for any financial report without making a separate request each time.

    ```js Build a local template lookup theme={null}
    // 1. Fetch all templates
    const { sablony } = await fetch(`/api/sablony`).then(r => r.json());

    // 2. Index by template ID for fast lookups
    const templateMap = Object.fromEntries(sablony.map(t => [t.id, t]));

    // 3. Resolve a template from a financial report
    const template = templateMap[report.idSablony];
    ```
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml ruz/openapi.json GET /api/sablony
openapi: 3.1.0
info:
  title: RÚZ API
  description: >-
    Public REST API for Slovakia's Register of Financial Statements (Register
    účtovných závierok). Exposes accounting units, financial statements,
    financial reports, and annual reports in JSON. Data is updated throughout
    the day as records are published.
  version: 2.5.0
  license:
    name: Creative Commons Zero (CC0)
    url: https://creativecommons.org/publicdomain/zero/1.0/
servers:
  - url: https://www.registeruz.sk/cruz-public
    description: Production
security: []
paths:
  /api/sablony:
    get:
      summary: List report templates
      description: >-
        Returns all financial report templates as a single list. No parameters
        required. Templates are never deleted.
      operationId: listReportTemplates
      responses:
        '200':
          description: All templates returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportTemplateList'
components:
  schemas:
    ReportTemplateList:
      type: object
      properties:
        sablony:
          type: array
          description: All report templates.
          items:
            $ref: '#/components/schemas/ReportTemplate'
    ReportTemplate:
      type: object
      description: >-
        Defines the row structure of a financial report's `tabulky`. Use
        `idSablony` from a financial report to find the matching template.
        Templates are never deleted.
      properties:
        id:
          type: integer
          description: Unique identifier.
        nazov:
          type: string
          description: Template name.
        nariadenieMF:
          type: string
          description: Ministry of Finance regulation reference.
        platneOd:
          type: string
          description: Valid from (`YYYY-MM-DD`).
        platneDo:
          type: string
          description: Valid to (`YYYY-MM-DD`). Absent if still in use.
        tabulky:
          type: array
          description: Table definitions.
          items:
            type: object
            properties:
              nazov:
                $ref: '#/components/schemas/LocalizedText'
              hlavicka:
                type: array
                description: Column headers with position and dimensions.
              riadky:
                type: array
                description: Row definitions with labels and row numbers.
    LocalizedText:
      type: object
      description: A text value with localized variants.
      properties:
        sk:
          type: string
          description: Slovak label.
        en:
          type: string
          description: English label.

````