Skip to main content
GET
/
subjects
Search subjects
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/subjects \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 12345678,
      "name": "Acme s.r.o.",
      "taxId": "2020123456",
      "vatId": "SK2020123456",
      "legalForm": "company",
      "city": "Bratislava",
      "street": "Main Street 1",
      "zip": "81101"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
searchQuery
string
required

Search string. This can be a company name or a business ID. Minimum length is 3 characters.

Minimum string length: 3
Example:

"acme"

​
legalForm
enum<string>

Optional legal form filter if you want to narrow the results to companies or freelancers only.

Available options:
freelancer,
company
Example:

"company"

​
limit
integer

Maximum number of results returned by the endpoint.

Required range: 1 <= x <= 20
Example:

5

Response

Returns matching subjects from the reference registry.

​
data
object[]

List of matching subjects.