# Zoznam faktúr

Vráti paginovaný zoznam faktúr aktuálnej firmy v zjednodušenom preview tvare. Tento endpoint je určený na listy, synchronizáciu a rýchly prehľad nad dokladmi. Na detail jedného dokladu použite detail endpoint faktúry.

Endpoint: GET /invoices
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `number` (string)
    Filter podľa čísla dokladu.
    Example: 2026

  - `clientId` (integer)
    Filter podľa klienta.
    Example: 101

  - `paymentStatus` (string)
    Filter podľa stavu úhrady.
    Enum: "paid", "unpaid", "partially_paid", "overdue", "will_not_be_paid"

  - `issueDateFrom` (string)
    Dátum vystavenia od.
    Example: "2026-02-01"

  - `issueDateTo` (string)
    Dátum vystavenia do.
    Example: "2026-02-28"

  - `dueDateFrom` (string)
    Dátum splatnosti od.
    Example: "2026-03-01"

  - `dueDateTo` (string)
    Dátum splatnosti do.
    Example: "2026-03-31"

  - `totalFrom` (number)
    Minimálna celková suma s DPH v mene firmy.
    Example: 100

  - `totalTo` (number)
    Maximálna celková suma s DPH v mene firmy.
    Example: 1000

  - `sortBy` (string)
    Pole pre triedenie. Podporované sú len hodnoty, ktoré podporuje interný list filter faktúr.
    Enum: "number", "issueDate", "dueDate", "deliveryDate", "totalWithVatEur"

  - `sortDirection` (string)
    Smer triedenia.
    Enum: "asc", "desc"

  - `perPage` (integer)
    Počet výsledkov na stránku.
    Example: 10

  - `page` (integer)
    Číslo stránky.
    Example: 2

## Response 200 fields (application/json):

  - `data` (array)
    Zoznam preview objektov faktúr pre aktuálnu stránku.

  - `data.id` (integer)
    Interné ID faktúry vo Fintoro.
    Example: 301

  - `data.uuid` (string)
    Stabilný UUID identifikátor faktúry.
    Example: "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

  - `data.type` (string)
    Typ dokladu.
    Example: "invoice"

  - `data.number` (string)
    Číslo faktúry.
    Example: "20260001"

  - `data.client` (object)
    Zjednodušený klient patriaci k faktúre.

  - `data.client.id` (integer)
    Interné ID klienta vo Fintoro.
    Example: 101

  - `data.client.name` (string)
    Meno osoby alebo obchodné meno klienta.
    Example: "Acme s.r.o."

  - `data.issueDate` (string)
    Dátum vystavenia faktúry.
    Example: "2026-03-03"

  - `data.dueDate` (string)
    Dátum splatnosti faktúry.
    Example: "2026-03-17"

  - `data.deliveryDate` (string)
    Dátum dodania.
    Example: "2026-03-03"

  - `data.currency` (object)
    Mena faktúry ako vnorený objekt.

  - `data.currency.id` (integer)
    Stabilné ID meny používané v API.
    Example: 1

  - `data.currency.symbol` (string)
    ISO alebo interný symbol meny.
    Example: "EUR"

  - `data.currency.name` (string)
    Názov meny.
    Example: "Euro"

  - `data.currency.mark` (string)
    Skrátená značka meny zobrazovaná vo Fintoro.
    Example: "€"

  - `data.currency.image` (string)
    URL adresa ikonky meny, ak je dostupná.
    Example: "https://example.test/images/currencies/eur.svg"

  - `data.total` (number)
    Celková suma bez DPH.
    Example: 200

  - `data.totalWithVat` (number)
    Celková suma s DPH.
    Example: 240

  - `data.toBePaid` (number)
    Zostávajúca suma na úhradu.
    Example: 240

  - `data.status` (string)
    Aktuálny stav úhrady faktúry.
    Enum: "paid", "unpaid", "partially_paid", "overdue", "will_not_be_paid"

  - `data.hasVat` (boolean)
    Informácia, či faktúra obsahuje položky s DPH.
    Example: true

  - `paginator` (object)
    Informácie o stránkovaní aktuálneho výsledku.

  - `paginator.currentPage` (integer)
    Aktuálna stránka výsledku.
    Example: 2

  - `paginator.perPage` (integer)
    Počet výsledkov na jednej stránke.
    Example: 10

  - `paginator.totalPages` (integer)
    Celkový počet stránok.
    Example: 5

  - `paginator.totalResults` (integer)
    Celkový počet záznamov naprieč všetkými stránkami.
    Example: 42

  - `paginator.currentFrom` (integer)
    Poradové číslo prvého záznamu na aktuálnej stránke.
    Example: 11

  - `paginator.currentTo` (integer)
    Poradové číslo posledného záznamu na aktuálnej stránke.
    Example: 20

  - `paginator.firstPageUrl` (string)
    URL prvej stránky.
    Example: "https://app.fintoro.sk/api/public/v1/invoices?page=1"

  - `paginator.lastPageUrl` (string)
    URL poslednej stránky.
    Example: "https://app.fintoro.sk/api/public/v1/invoices?page=5"

  - `paginator.nextPageUrl` (string,null)
    URL ďalšej stránky alebo null, ak ďalšia stránka neexistuje.
    Example: "https://app.fintoro.sk/api/public/v1/invoices?page=3"

  - `paginator.previousPageUrl` (string,null)
    URL predchádzajúcej stránky alebo null, ak predchádzajúca stránka neexistuje.
    Example: "https://app.fintoro.sk/api/public/v1/invoices?page=1"

  - `paginator.links` (array)
    Kompletný zoznam stránkovacích linkov v poradí, v akom ich vracia backend.

  - `paginator.links.url` (string,null)
    URL cieľovej stránky alebo null, ak daný link nie je dostupný.
    Example: "https://app.fintoro.sk/api/public/v1/invoices?page=2"

  - `paginator.links.label` (string)
    Textový label linku.
    Example: "2"

  - `paginator.links.active` (boolean)
    Označuje, či ide o aktuálne aktívnu stránku.

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Server Error"

## Response 503 fields (application/json):

  - `message` (string)
    Example: "Service Unavailable"