Přejít na hlavní obsah
GET
/
subjects
/
{subject}
Detail subjektu
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/subjects/{subject} \
  --header 'Authorization: Bearer <token>'
{
  "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 cesty

​
subject
integer
povinné

ID subjektu z referenčného registra.

Příklad:

12345678

Odpověď

Vracia detail požadovaného subjektu.

Subjekt z referenčného registra. Typicky ho použijete ako podklad pri vytváraní klienta.

​
id
integer

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu zvyčajne viete nájsť aj cez referenčný register subjektov.

Příklad:

12345678

​
name
string

Obchodné meno alebo názov subjektu.

Příklad:

"Acme s.r.o."

​
taxId
string | null

DIČ subjektu, ak je dostupné.

Příklad:

"2020123456"

​
vatId
string | null

IČ DPH subjektu, ak je dostupné.

Příklad:

"SK2020123456"

​
legalForm
enum<string>

Právna forma subjektu.

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

"company"

​
city
string | null

Mesto sídla alebo miesta podnikania.

Příklad:

"Bratislava"

​
street
string | null

Ulica a číslo sídla alebo miesta podnikania.

Příklad:

"Hlavná 1"

​
zip
string | null

PSČ sídla alebo miesta podnikania.

Příklad:

"81101"