List invoices

GET

invoices

List invoices

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/invoices \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/invoices"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.fintoro.sk/api/public/v1/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.fintoro.sk/api/public/v1/invoices")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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": "Main Street 1",
        "city": "Bratislava",
        "zip": "81101",
        "countryId": 703,
        "country": {
          "id": 703,
          "name": "Slovakia",
          "code": "SK",
          "eu": true
        },
        "hasDeliveryAddress": true,
        "deliveryStreet": "Warehouse 9",
        "deliveryCity": "Kosice",
        "deliveryZip": "04001",
        "deliveryCountryId": 703,
        "deliveryCountry": {
          "id": 703,
          "name": "Slovakia",
          "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
      }
    ]
  }
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Query Parameters

number

string

Filter by document number.

clientId

integer

Filter by client.

paymentStatus

enum<string>

Filter by payment status.

Available options:

paid,

unpaid,

partially_paid,

overdue,

will_not_be_paid

issueDateFrom

string<date>

Issue date from.

issueDateTo

string<date>

Issue date to.

dueDateFrom

string<date>

Due date from.

dueDateTo

string<date>

Due date to.

deliveryDateFrom

string<date>

Delivery date from.

deliveryDateTo

string<date>

Delivery date to.

totalFrom

number<float>

Minimum total amount with VAT in company currency.

totalTo

number<float>

Maximum total amount with VAT in company currency.

sortBy

enum<string>

default:issueDate

Field used for sorting. Only values supported by the underlying invoice list filter are accepted.

Available options:

number,

issueDate,

dueDate,

deliveryDate,

totalWithVatEur

sortDirection

enum<string>

default:desc

Sorting direction.

Available options:

asc,

desc

perPage

integer

default:10

Number of results per page.

Required range: 1 <= x <= 500

page

integer

default:1

Page number.

Required range: x >= 1

Response

Paginated invoice list in preview shape.

data

object[]

List of invoice preview objects for the current page.

Show child attributes

paginator

object

Pagination information for the current result set.

Show child attributes

Create invoiceCreates a new invoice. ### Recommended flow The recommended happy path is to send `clientId` and `items`. This is the simplest flow when the client already exists in Fintoro. If the client does not exist yet or you do not want to perform a separate client create step, send the `client` object without `clientId`. The backend attempts to match an existing client and creates a new one only when no match is found. If you send both `clientId` and `client`, the `client` object acts as a sparse snapshot override for this specific document. This lets you adjust, for example, the delivery address or contact details only for this invoice without changing the stored client record. ### How defaults are resolved Most document fields are optional. The backend resolves them in this order: 1. explicit value from the payload, 2. client default values, 3. company document settings, 4. system resolver. In practice, this means for example: - `deliveryMethodId`, `paymentMethodId`, `currencyId`, and `languageId` may be resolved from the client or company settings, - `number` and `numericalSeriesId` are resolved from the primary numbering series when omitted, - `variableSymbol` is derived from the final document number when omitted, - `bankAccountId` falls back to the primary company bank account when omitted, - `currencyRate` is resolved from the currency and delivery date, - if the final document currency is `EUR`, the backend always stores and returns `currencyRate = 1.0`, even when you send a different value, - `issueDate` and `deliveryDate` default to today. ### How client resolution works Client resolution is strictly deterministic: - when you send `clientId`, the backend loads that client by ID within the token scope, - when `clientId` is omitted, the `client` object is used to match or create the client, - when you send both `clientId` and `client`, `client` is applied only as a snapshot override for this document. Matching is deterministic and follows this order: - for companies: `vatId`, then `countryId + subjectId`, then `name + email`, then `name + street`, - for people: `name + email`, then `name + street`. If no match is found, a new client is created. If more than one client matches, the backend uses the first record in a stable order. If you send an explicit `clientId` that does not exist or is outside the token scope, the endpoint returns a `422` validation error on `clientId`. If you send an explicit `bankAccountId` and that record does not exist or is outside the token scope, the endpoint returns a `422` validation error on `bankAccountId`. If you omit `bankAccountId` and the company has no primary bank account configured, the endpoint returns `422`. ### How line items work A line item can be created in three ways: 1. as a manual item with its own name, unit, price, and VAT rate, 2. through `priceListItemId` and `quantity`, 3. through `priceListItemId` and sparse overrides for selected fields such as the price or name. If you send a discount without `discountName`, the backend fills in a localized default discount label based on the document language. ### Request examples Existing client with a manual item: ```json { "clientId": 101, "issueDate": "2026-03-04", "items": [ { "name": "Monthly retainer", "quantity": 1, "unitId": 1, "unitPrice": 120.0, "vatRate": 23 } ] } ``` Inline client without `clientId`: ```json { "client": { "type": "company", "name": "Acme s.r.o.", "email": "billing@acme.test", "countryId": 703, "subjectId": "12345678", "street": "Hlavna 1", "city": "Bratislava", "zip": "81101" }, "items": [ { "name": "API implementation", "quantity": 10, "unitId": 7, "unitPrice": 80.0, "vatRate": 23 } ] } ``` Price list item with the minimum payload: ```json { "clientId": 101, "items": [ { "priceListItemId": 501, "quantity": 2 } ] } ``` If you send an `Idempotency-Key`, the same key with the same payload returns the original response without creating the invoice again.

List invoices

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/invoices \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/invoices"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.fintoro.sk/api/public/v1/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.fintoro.sk/api/public/v1/invoices")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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": "Main Street 1",
        "city": "Bratislava",
        "zip": "81101",
        "countryId": 703,
        "country": {
          "id": 703,
          "name": "Slovakia",
          "code": "SK",
          "eu": true
        },
        "hasDeliveryAddress": true,
        "deliveryStreet": "Warehouse 9",
        "deliveryCity": "Kosice",
        "deliveryZip": "04001",
        "deliveryCountryId": 703,
        "deliveryCountry": {
          "id": 703,
          "name": "Slovakia",
          "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
      }
    ]
  }
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Authorizations

Query Parameters

Response