Skip to main content
GET
/
clients
/
{client}
Show client
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": "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."
}

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.

id
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

email
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

Client billing country as a nested object.

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

Client delivery country as a nested object.

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