Show client

GET

clients

{client}

Show client

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": "Main Street 1",
  "city": "Bratislava",
  "zip": "81101",
  "country": {
    "id": 703,
    "name": "Slovakia",
    "code": "SK",
    "eu": true
  },
  "hasDeliveryAddress": true,
  "deliveryStreet": "Warehouse Street 9",
  "deliveryCity": "Kosice",
  "deliveryZip": "04001",
  "deliveryCountry": {
    "id": 703,
    "name": "Slovakia",
    "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": "Due within 14 days.",
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Thank you for your cooperation."
}

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

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

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

Path Parameters

client

integer

required

Client ID.

Example:

101

Response

Client detail.

Client, including client-scoped default values. The API does not apply these values automatically, but you can reuse them as recommended defaults when building payloads for new documents.

integer

Internal client ID in Fintoro.

Example:

101

name

string

Person name or company name.

Example:

"Acme s.r.o."

type

enum<string>

Client type. person represents an individual person, while company represents a company or self-employed business entity.

Available options:

person,

company

Example:

"company"

subjectId

string | null

Business ID of the client or company. For Slovak entities, you can typically also find this value through the subject registry lookup.

Example:

"12345678"

taxId

string | null

Client tax ID, when available.

Example:

"2020123456"

vatId

string | null

Client VAT ID, when available.

Example:

"SK2020123456"

isVatPayer

boolean

Indicates whether the client is currently recorded as a VAT payer.

Example:

true

string | null

Client contact email.

Example:

"billing@acme.test"

street

string | null

Street and number of the billing address.

Example:

"Main Street 1"

city

string | null

City of the billing address.

Example:

"Bratislava"

zip

string | null

ZIP or postal code of the billing address.

Example:

"81101"

country

object | null

Client billing country as a nested object.

Show child attributes

hasDeliveryAddress

boolean

Indicates whether the client has a dedicated delivery address different from the billing address.

Example:

true

deliveryStreet

string | null

Street and number of the delivery address.

Example:

"Warehouse Street 9"

deliveryCity

string | null

City of the delivery address.

Example:

"Kosice"

deliveryZip

string | null

ZIP or postal code of the delivery address.

Example:

"04001"

deliveryCountry

object | null

Client delivery country as a nested object.

Show child attributes

createdAt

string<date-time> | null

Date and time when the client was created.

Example:

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

updatedAt

string<date-time> | null

Date and time when the client was last updated.

Example:

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

preferredDeliveryMethodId

integer | null

Default delivery method for the client. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload. The value comes from the delivery method reference table.

Example:

1

preferredPaymentMethodId

integer | null

Default payment method for the client. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload. The value comes from the payment method reference table.

Example:

1

preferredCurrencyId

integer | null

Default currency for the client. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload. The value comes from the currency reference table.

Example:

1

preferredLanguageId

integer | null

Default language for the client. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload. The value comes from the language reference table.

Example:

1

preferredDueDays

integer | null

Default due days. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload.

Example:

14

preferredNote

string | null

Default note. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload.

Example:

"Due within 14 days."

preferredVariableSymbol

integer | null

Default variable symbol. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload.

Example:

2026001

preferredConstantSymbol

integer | null

Default constant symbol. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload.

Example:

308

preferredSpecificSymbol

integer | null

Default specific symbol. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload.

Example:

55

preferredTextAboveItems

string | null

Default text above items. It is stored on the client and used as a fallback default when creating new documents for this client if you do not send an explicit value in the payload.

Example:

"Thank you for your cooperation."

Show client

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": "Main Street 1",
  "city": "Bratislava",
  "zip": "81101",
  "country": {
    "id": 703,
    "name": "Slovakia",
    "code": "SK",
    "eu": true
  },
  "hasDeliveryAddress": true,
  "deliveryStreet": "Warehouse Street 9",
  "deliveryCity": "Kosice",
  "deliveryZip": "04001",
  "deliveryCountry": {
    "id": 703,
    "name": "Slovakia",
    "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": "Due within 14 days.",
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Thank you for your cooperation."
}

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

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

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Authorizations

Path Parameters

Response