Přejít na hlavní obsah
GET
/
subjects
Vyhľadávanie subjektov
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": "Hlavná 1",
      "zip": "81101"
    }
  ]
}

Autorizace

​
Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Parametry dotazu

​
searchQuery
string
povinné

Hľadaný reťazec. Môže to byť názov subjektu alebo IČO. Minimum sú 3 znaky.

Minimum string length: 3
Příklad:

"acme"

​
legalForm
enum<string>

Voliteľný filter podľa právnej formy, ak chcete výsledky zúžiť len na firmy alebo živnostníkov.

Dostupné možnosti:
freelancer,
company
Příklad:

"company"

​
limit
integer

Maximálny počet výsledkov, ktoré endpoint vráti.

Požadovaný rozsah: 1 <= x <= 20
Příklad:

5

Odpověď

Vracia zodpovedajúce subjekty z referenčného registra.

​
data
object[]

Zoznam nájdených subjektov.