Skip to main content
GET
/
clients
List clients
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/clients \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "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.

Query Parameters

​
search
string

Full-text search by name, city, ZIP code, or country.

Example:

"bratislava"

​
sortBy
enum<string>
default:name

Field used to sort clients.

Available options:
name,
city,
zip,
countryId,
createdAt,
updatedAt
Example:

"name"

​
sortDirection
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc
Example:

"desc"

​
type
enum<string>

Filter by client type.

Available options:
person,
company
Example:

"company"

​
subjectId
string

Filter by the client's or company's business ID.

Example:

"12345678"

​
taxId
string

Filter by the client's or company's tax ID.

Example:

"2020123456"

​
vatId
string

Filter by the client's or company's VAT ID.

Example:

"SK2020123456"

​
countryId
integer

Filter by the client's billing country from the country reference table.

Example:

703

Response

Client list.

​
data
object[]

List of clients.