# Zoznam klientov

Vráti klientov patriacich aktuálnej firme. Endpoint je vhodný na synchronizáciu klientov do externého systému alebo vlastného frontendu a podporuje základné fulltextové vyhľadávanie, filtrovanie a triedenie.

Endpoint: GET /clients
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `search` (string)
    Fulltextové vyhľadávanie podľa názvu, mesta, PSČ alebo krajiny.
    Example: "bratislava"

  - `sortBy` (string)
    Pole, podľa ktorého sa majú klienti zoradiť.
    Enum: "name", "city", "zip", "countryId", "createdAt", "updatedAt"

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

  - `type` (string)
    Filter podľa typu klienta.
    Enum: "person", "company"

  - `subjectId` (string)
    Filter podľa IČO klienta alebo firmy.
    Example: "12345678"

  - `taxId` (string)
    Filter podľa DIČ klienta alebo firmy.
    Example: "2020123456"

  - `vatId` (string)
    Filter podľa IČ DPH klienta alebo firmy.
    Example: "SK2020123456"

  - `countryId` (integer)
    Filter podľa fakturačnej krajiny klienta z referenčnej tabuľky krajín.
    Example: 703

## Response 200 fields (application/json):

  - `data` (array)
    Zoznam klientov patriacich aktuálnej firme.

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

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

  - `data.type` (string)
    Typ klienta. Hodnota person reprezentuje fyzickú osobu, hodnota company firmu alebo živnostníka evidovaného ako podnikateľský subjekt.
    Enum: "person", "company"

  - `data.subjectId` (string,null)
    IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez [referenčný register subjektov](#operation/searchSubjects).
    Example: "12345678"

  - `data.taxId` (string,null)
    DIČ klienta, ak je dostupné.
    Example: "2020123456"

  - `data.vatId` (string,null)
    IČ DPH klienta, ak je dostupné.
    Example: "SK2020123456"

  - `data.isVatPayer` (boolean)
    Informácia, či je klient aktuálne evidovaný ako platca DPH.
    Example: true

  - `data.email` (string,null)
    Kontaktný e-mail klienta.
    Example: "billing@acme.test"

  - `data.street` (string,null)
    Ulica a číslo fakturačnej adresy.
    Example: "Hlavná 1"

  - `data.city` (string,null)
    Mesto fakturačnej adresy.
    Example: "Bratislava"

  - `data.zip` (string,null)
    PSČ fakturačnej adresy.
    Example: "81101"

  - `data.country` (any)
    Fakturačná krajina klienta ako vnorený objekt.

  - `data.hasDeliveryAddress` (boolean)
    Informácia, či má klient uloženú samostatnú dodaciu adresu odlišnú od fakturačnej adresy.
    Example: true

  - `data.deliveryStreet` (string,null)
    Ulica a číslo dodacej adresy.
    Example: "Skladová 9"

  - `data.deliveryCity` (string,null)
    Mesto dodacej adresy.
    Example: "Košice"

  - `data.deliveryZip` (string,null)
    PSČ dodacej adresy.
    Example: "04001"

  - `data.deliveryCountry` (any)
    Dodacia krajina klienta ako vnorený objekt.

  - `data.createdAt` (string,null)
    Dátum a čas vytvorenia klienta.
    Example: "2026-03-03T12:00:00+01:00"

  - `data.updatedAt` (string,null)
    Dátum a čas poslednej úpravy klienta.
    Example: "2026-03-03T15:45:00+01:00"

  - `data.preferredDeliveryMethodId` (integer,null)
    Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky spôsobov dodania](./reference-tables.md#sposoby-dodania).
    Example: 1

  - `data.preferredPaymentMethodId` (integer,null)
    Predvolená hodnota spôsobu úhrady pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky spôsobov úhrady](./reference-tables.md#sposoby-uhrady).
    Example: 1

  - `data.preferredCurrencyId` (integer,null)
    Predvolená hodnota meny pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky mien](./reference-tables.md#meny).
    Example: 1

  - `data.preferredLanguageId` (integer,null)
    Predvolená hodnota jazyka pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z [referenčnej tabuľky jazykov](./reference-tables.md#jazyky).
    Example: 1

  - `data.preferredDueDays` (integer,null)
    Predvolený počet dní splatnosti. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 14

  - `data.preferredNote` (string,null)
    Predvolená poznámka. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: "Splatnosť 14 dní."

  - `data.preferredVariableSymbol` (integer,null)
    Predvolený variabilný symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 2026001

  - `data.preferredConstantSymbol` (integer,null)
    Predvolený konštantný symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 308

  - `data.preferredSpecificSymbol` (integer,null)
    Predvolený špecifický symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: 55

  - `data.preferredTextAboveItems` (string,null)
    Predvolený text nad položkami. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.
    Example: "Dakujeme za spoluprácu."

## Response 500 fields (application/json):

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

## Response 503 fields (application/json):

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