Přejít na hlavní obsah
GET
/
clients
Zoznam klientov
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/clients \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 101,
      "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",
      "country": {
        "id": 703,
        "name": "Slovensko",
        "code": "SK",
        "eu": true
      },
      "hasDeliveryAddress": true,
      "deliveryStreet": "Skladová 9",
      "deliveryCity": "Košice",
      "deliveryZip": "04001",
      "deliveryCountry": {
        "id": 703,
        "name": "Slovensko",
        "code": "SK",
        "eu": true
      },
      "createdAt": "2026-03-03T12:00:00+01:00",
      "updatedAt": "2026-03-03T15:45:00+01:00",
      "preferredDeliveryMethodId": 1,
      "preferredPaymentMethodId": 1,
      "preferredCurrencyId": 1,
      "preferredLanguageId": 1,
      "preferredDueDays": 14,
      "preferredNote": "Splatnosť 14 dní.",
      "preferredVariableSymbol": 2026001,
      "preferredConstantSymbol": 308,
      "preferredSpecificSymbol": 55,
      "preferredTextAboveItems": "Dakujeme za spoluprácu."
    }
  ]
}

Autorizace

Authorization
string
header
povinné

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

Parametry dotazu

Fulltextové vyhľadávanie podľa názvu, mesta, PSČ alebo krajiny.

Příklad:

"bratislava"

sortBy
enum<string>
výchozí:name

Pole, podľa ktorého sa majú klienti zoradiť.

Dostupné možnosti:
name,
city,
zip,
countryId,
createdAt,
updatedAt
Příklad:

"name"

sortDirection
enum<string>
výchozí:asc

Smer zoradenia.

Dostupné možnosti:
asc,
desc
Příklad:

"desc"

type
enum<string>

Filter podľa typu klienta.

Dostupné možnosti:
person,
company
Příklad:

"company"

subjectId
string

Filter podľa IČO klienta alebo firmy.

Příklad:

"12345678"

taxId
string

Filter podľa DIČ klienta alebo firmy.

Příklad:

"2020123456"

vatId
string

Filter podľa IČ DPH klienta alebo firmy.

Příklad:

"SK2020123456"

countryId
integer

Filter podľa fakturačnej krajiny klienta z referenčnej tabuľky krajín.

Příklad:

703

Odpověď

Zoznam klientov.

data
object[]

Zoznam klientov.