Detail klienta

GET

clients

{client}

Detail klienta

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

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

fetch('https://app.fintoro.sk/api/public/v1/clients/{client}', 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/clients/{client}",
  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/clients/{client}"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/clients/{client}")

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

{
  "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."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

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.

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

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 | null

Fakturačná krajina klienta ako vnorený objekt.

Show child attributes

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 | null

Dodacia krajina klienta ako vnorený objekt.

Show child attributes

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

Detail klienta

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

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

fetch('https://app.fintoro.sk/api/public/v1/clients/{client}', 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/clients/{client}",
  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/clients/{client}"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/clients/{client}")

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

{
  "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."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Prehľad

Endpointy

Autorizace

Parametry cesty

Odpověď