> ## 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 annual reports

> Returns a paginated list of annual report IDs.

* This endpoint returns **IDs only**.
* Use these IDs with [Get annual report](/ruz/api-reference/entity-details/get-annual-report) to fetch full records.
* To page through results, see [Pagination](/ruz/getting-started/pagination).


## OpenAPI

````yaml ruz/openapi.json GET /api/vyrocne-spravy
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/vyrocne-spravy:
    get:
      summary: List annual reports
      description: >-
        Returns a paginated list of annual report IDs changed on or after
        `zmenene-od`.
      operationId: listAnnualReports
      parameters:
        - $ref: '#/components/parameters/zmeneneOd'
        - $ref: '#/components/parameters/pokracuvatZaId'
        - $ref: '#/components/parameters/maxZaznamov'
      responses:
        '200':
          description: List of matching IDs returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdListResponse'
        '400':
          description: Missing or invalid `zmenene-od` parameter.
components:
  parameters:
    zmeneneOd:
      name: zmenene-od
      in: query
      required: true
      description: >-
        Return IDs changed on or after this date. Accepts `YYYY-MM-DD` or
        `YYYY-MM-DDThh:mm:ssZ`.
      schema:
        type: string
        example: '2000-01-01'
    pokracuvatZaId:
      name: pokracovat-za-id
      in: query
      description: Pagination cursor. Pass the last `id` from the previous response.
      schema:
        type: integer
    maxZaznamov:
      name: max-zaznamov
      in: query
      description: Maximum number of IDs to return. Default 1000, maximum 10000.
      schema:
        type: integer
        default: 1000
        maximum: 10000
  schemas:
    IdListResponse:
      type: object
      description: Paginated list of entity IDs.
      properties:
        id:
          type: array
          description: Array of entity IDs. Empty array if no results match.
          items:
            type: integer
        existujeDalsieId:
          type: boolean
          description: >-
            When `true`, more IDs exist. Fetch the next page by passing the last
            ID in this response as `pokracovat-za-id`.

````