Přejít na hlavní obsah
GET
/
clients
/
{client}
Detail klienta
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/clients/{client} \
  --header 'Authorization: Bearer <token>'
{
  "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 cesty

​
client
integer
povinné

ID klienta.

Příklad:

101

Odpověď

Detail klienta.

Klient vrátane klientských predvolených hodnôt. Tieto hodnoty neaplikuje API automaticky, ale môžete ich použiť ako odporúčaný default pri skladaní payloadov nových dokladov.

​
id
integer

Interné ID klienta vo Fintoro.

Příklad:

101

​
name
string

Meno osoby alebo obchodné meno klienta.

Příklad:

"Acme s.r.o."

​
type
enum<string>

Typ klienta. Hodnota person reprezentuje fyzickú osobu, hodnota company firmu alebo živnostníka evidovaného ako podnikateľský subjekt.

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

"company"

​
subjectId
string | null

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez referenčný register subjektov.

Příklad:

"12345678"

​
taxId
string | null

DIČ klienta, ak je dostupné.

Příklad:

"2020123456"

​
vatId
string | null

IČ DPH klienta, ak je dostupné.

Příklad:

"SK2020123456"

​
isVatPayer
boolean

Informácia, či je klient aktuálne evidovaný ako platca DPH.

Příklad:

true

​
email
string | null

Kontaktný e-mail klienta.

Příklad:

"billing@acme.test"

​
street
string | null

Ulica a číslo fakturačnej adresy.

Příklad:

"Hlavná 1"

​
city
string | null

Mesto fakturačnej adresy.

Příklad:

"Bratislava"

​
zip
string | null

PSČ fakturačnej adresy.

Příklad:

"81101"

​
country
object

Fakturačná krajina klienta ako vnorený objekt.

​
hasDeliveryAddress
boolean

Informácia, či má klient uloženú samostatnú dodaciu adresu odlišnú od fakturačnej adresy.

Příklad:

true

​
deliveryStreet
string | null

Ulica a číslo dodacej adresy.

Příklad:

"Skladová 9"

​
deliveryCity
string | null

Mesto dodacej adresy.

Příklad:

"Košice"

​
deliveryZip
string | null

PSČ dodacej adresy.

Příklad:

"04001"

​
deliveryCountry
object

Dodacia krajina klienta ako vnorený objekt.

​
createdAt
string<date-time> | null

Dátum a čas vytvorenia klienta.

Příklad:

"2026-03-03T12:00:00+01:00"

​
updatedAt
string<date-time> | null

Dátum a čas poslednej úpravy klienta.

Příklad:

"2026-03-03T15:45:00+01:00"

​
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.

Příklad:

1

​
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.

Příklad:

1

​
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.

Příklad:

1

​
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.

Příklad:

1

​
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.

Příklad:

14

​
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.

Příklad:

"Splatnosť 14 dní."

​
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.

Příklad:

2026001

​
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.

Příklad:

308

​
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.

Příklad:

55

​
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.

Příklad:

"Dakujeme za spoluprácu."