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

# Get annual report

> Returns the full record for a single annual report.

To get an annual report ID, use [List annual reports](/ruz/api-reference/identifier-lists/list-annual-reports).

<Tip>Learn more about [Data access](/ruz/getting-started/data-access) pattern used across the RÚZ API.</Tip>

***

## Common patterns

<AccordionGroup>
  <Accordion title="Follow links to financial reports">
    The response includes `idUctovnychVykazov` which is an array of financial report IDs. You can fetch each one with [Get financial report](/ruz/api-reference/entity-details/get-financial-report) to retrieve the full report (tables, cover page, attachments).

    ```js Fetch financial reports linked to this annual report theme={null}
    // 1. Fetch the annual report
    const annualReport = await fetchAnnualReport(2613005);

    // 2. Fetch all financial reports linked to this annual report
    const reports = await Promise.all(
      (annualReport.idUctovnychVykazov ?? []).map(id => fetchReport(id))
    );
    ```
  </Accordion>

  <Accordion title="Downloading attachments">
    Annual reports can include attachments such as scanned documents and PDFs. These are listed in the `prilohy` array.

    Download the file from the attachment URL:
    <span className="text-sm">`https://www.registeruz.sk/domain/financialreport/attachment/{id}`</span>

    ```js Download an attachment from an annual report theme={null}
    // 1. Pick the first attachment from the report
    const attachment = annualReport.prilohy[0];

    // 2. Download the file from the attachment URL
    const file = await fetch(
      `https://www.registeruz.sk/domain/financialreport/attachment/${attachment.id}`
    );
    ```

    <Info>Reports with `pristupnostDat: "Neverejné"` return metadata and structure only — attachments are not publicly available.</Info>
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml ruz/openapi.json GET /api/vyrocna-sprava
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/vyrocna-sprava:
    get:
      summary: Get annual report
      description: >-
        Returns the full record for a single annual report, including
        attachments and links to associated financial reports.


        Obtain annual report IDs from `idVyrocnychSprav` on an [accounting
        unit](/api-reference/get-accounting-unit).
      operationId: getAnnualReport
      parameters:
        - $ref: '#/components/parameters/id'
      responses:
        '200':
          description: Annual report returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnualReport'
        '404':
          description: No annual report found with the given `id`.
components:
  parameters:
    id:
      name: id
      in: query
      required: true
      description: Entity identifier — obtained from an identifier list endpoint.
      schema:
        type: integer
  schemas:
    AnnualReport:
      type: object
      description: An annual report (výročná správa) belonging to an accounting unit.
      properties:
        id:
          type: integer
          description: Unique identifier.
        idUJ:
          type: integer
          description: ID of the parent accounting unit.
        nazovUJ:
          type: string
          description: Name of the accounting unit at time of filing.
        typ:
          type: string
          enum:
            - Ročná finančná správa
            - Individuálna výročná správa
            - Konsolidovaná výročná správa
            - Súhrnná výročná správa SR
          description: Report type.
        obdobieOd:
          type: string
          description: Period start (`YYYY-MM`).
        obdobieDo:
          type: string
          description: Period end (`YYYY-MM`).
        datumPodania:
          type: string
          description: Date filed (`YYYY-MM-DD`).
        datumZostaveniaK:
          type: string
          description: Balance sheet date (`YYYY-MM-DD`).
        nazovFondu:
          type: string
          description: Fund name — present only for fund reports.
        leiKod:
          type: string
          description: LEI code (20 characters).
        pristupnostDat:
          type: string
          enum:
            - Verejné
            - Neverejné
          description: Data accessibility.
        idUctovnychVykazov:
          type: array
          items:
            type: integer
          description: IDs of linked financial reports.
        prilohy:
          type: array
          description: >-
            Downloadable attachments. Fetch each file at
            `/domain/financialreport/attachment/{id}`.
          items:
            $ref: '#/components/schemas/Attachment'
        zdrojDat:
          type: string
          description: Data source code.
        datumPoslednejUpravy:
          type: string
          description: Date last modified (`YYYY-MM-DD`).
    Attachment:
      type: object
      description: >-
        A downloadable file attachment. Fetch at
        `/domain/financialreport/attachment/{id}`.
      properties:
        id:
          type: integer
          description: Attachment identifier.
        meno:
          type: string
          description: Filename.
        mimeType:
          type: string
          description: MIME type (e.g. `image/tiff`, `application/pdf`).
        velkostPrilohy:
          type: integer
          description: File size in bytes.
        pocetStran:
          type: integer
          description: Number of pages.
        digest:
          type: string
          description: SHA-256 hash for integrity verification.
        jazyk:
          type: string
          description: Language code of the attachment.

````