List suppliers - Fintoro API

GET

suppliers

List suppliers

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

{
  "data": [
    {
      "id": 151,
      "type": "company",
      "name": "Supplier s.r.o.",
      "subjectId": "12345678",
      "taxId": "2020202020",
      "vatId": "SK2020202020",
      "isVatPayer": true,
      "email": "billing@supplier.test",
      "street": "Supplier Street 1",
      "city": "Bratislava",
      "zip": "81101",
      "country": {
        "id": 703,
        "name": "Slovakia",
        "code": "SK",
        "eu": true
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Query Parameters

string

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

Example:

"bratislava"

sortBy

enum<string>

default:name

Field used for sorting suppliers.

Available options:

name,

city,

zip,

createdAt,

updatedAt

Example:

"name"

sortDirection

enum<string>

default:asc

Sorting direction.

Available options:

asc,

desc

Example:

"desc"

Response

Supplier list.

data

object[]

Suppliers.

Show child attributes

Create supplierCreates a new supplier. If you omit `type`, the backend infers it from `subjectId`, `taxId`, and `vatId`. If you omit `isVatPayer`, the backend infers it from `vatId`. If you send `Idempotency-Key`, the same key with the same payload returns the original response instead of creating a duplicate supplier.

List suppliers

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

{
  "data": [
    {
      "id": 151,
      "type": "company",
      "name": "Supplier s.r.o.",
      "subjectId": "12345678",
      "taxId": "2020202020",
      "vatId": "SK2020202020",
      "isVatPayer": true,
      "email": "billing@supplier.test",
      "street": "Supplier Street 1",
      "city": "Bratislava",
      "zip": "81101",
      "country": {
        "id": 703,
        "name": "Slovakia",
        "code": "SK",
        "eu": true
      }
    }
  ]
}