Přejít na hlavní obsah
GET
/
invoices
Zoznam faktúr
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/invoices \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 301,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "type": "invoice",
      "number": "20260001",
      "clientId": 101,
      "client": {
        "name": "Acme s.r.o.",
        "type": "company",
        "subjectId": "12345678",
        "taxId": "2020123456",
        "vatId": "SK2020123456",
        "isVatPayer": true,
        "email": "billing@acme.test",
        "street": "Hlavná 1",
        "city": "Bratislava",
        "zip": "81101",
        "countryId": 703,
        "country": {
          "id": 703,
          "name": "Slovensko",
          "code": "SK",
          "eu": true
        },
        "hasDeliveryAddress": true,
        "deliveryStreet": "Skladová 9",
        "deliveryCity": "Košice",
        "deliveryZip": "04001",
        "deliveryCountryId": 703,
        "deliveryCountry": {
          "id": 703,
          "name": "Slovensko",
          "code": "SK",
          "eu": true
        }
      },
      "issueDate": "2026-03-03",
      "dueDate": "2026-03-17",
      "deliveryDate": "2026-03-03",
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "total": 200,
      "totalWithVat": 240,
      "toBePaid": 240,
      "status": "unpaid",
      "hasVat": true
    }
  ],
  "paginator": {
    "currentPage": 2,
    "perPage": 10,
    "totalPages": 5,
    "totalResults": 42,
    "currentFrom": 11,
    "currentTo": 20,
    "firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
    "nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
    "previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "links": [
      {
        "url": "https://app.fintoro.sk/api/public/v1/invoices?page=2",
        "label": "2",
        "active": false
      }
    ]
  }
}

Autorizace

​
Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Parametry dotazu

​
number
string

Filter podľa čísla dokladu.

​
clientId
integer

Filter podľa klienta.

​
paymentStatus
enum<string>

Filter podľa stavu úhrady.

Dostupné možnosti:
paid,
unpaid,
partially_paid,
overdue,
will_not_be_paid
​
issueDateFrom
string<date>

Dátum vystavenia od.

​
issueDateTo
string<date>

Dátum vystavenia do.

​
dueDateFrom
string<date>

Dátum splatnosti od.

​
dueDateTo
string<date>

Dátum splatnosti do.

​
totalFrom
number<float>

Minimálna celková suma s DPH v mene firmy.

​
totalTo
number<float>

Maximálna celková suma s DPH v mene firmy.

​
sortBy
enum<string>
výchozí:issueDate

Pole pre triedenie. Podporované sú len hodnoty, ktoré podporuje interný list filter faktúr.

Dostupné možnosti:
number,
issueDate,
dueDate,
deliveryDate,
totalWithVatEur
​
sortDirection
enum<string>
výchozí:desc

Smer triedenia.

Dostupné možnosti:
asc,
desc
​
perPage
integer
výchozí:10

Počet výsledkov na stránku.

Požadovaný rozsah: 1 <= x <= 500
​
page
integer
výchozí:1

Číslo stránky.

Požadovaný rozsah: x >= 1

Odpověď

Paginovaný zoznam faktúr v preview tvare.

​
data
object[]

Zoznam náhľadový objektov faktúr pre aktuálnu stránku.

​
paginator
object

Informácie o stránkovaní aktuálneho výsledku.