Detail bankového účtu

GET

bank-accounts

{bankAccount}

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 23,
    "name": "Tatra Banka",
    "swift": "TATRSKBX"
  },
  "isPrimary": true,
  "autoPaymentMatching": true,
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "balance": 1234.56,
  "lastSyncedAt": "2026-03-01 10:15:16",
  "openBankingValidUntil": "2026-04-30",
  "createdAt": "2026-03-03 12:00:00",
  "updatedAt": "2026-03-03 15:45:00"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Autorizace

Authorization

string

header

povinné

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

Parametry cesty

bankAccount

integer

povinné

ID bankového účtu.

Příklad:

201

Odpověď

Detail bankového účtu.

Bankový účet. Objekt spája business údaje účtu, informáciu o banke a stav napojenia na open banking.

integer

Interné ID bankového účtu vo Fintoro.

Příklad:

201

bankId

integer | null

ID banky z lookup endpointu bánk. Ak je null, účet nie je naviazaný na konkrétnu banku z lookupu.

Příklad:

1

bank

object | null

Vnorený objekt banky zodpovedajúci bankId, ak je banka známa a stále dostupná v lookup datasete.

Show child attributes

isPrimary

boolean

Označuje, či je tento účet aktuálne vedený ako primárny bankový účet firmy.

Příklad:

true

autoPaymentMatching

boolean

Označuje, či je účet aktuálne napojený na automatické párovanie platieb cez open banking. Hodnota je odvodená od existencie open banking napojenia, neposiela sa v requeste.

Příklad:

true

name

string

Používateľský názov bankového účtu zobrazený vo Fintoro.

Příklad:

"Hlavný účet"

iban

string

IBAN bankového účtu.

Příklad:

"SK3111000000001234567890"

swift

string

SWIFT alebo BIC kód bankového účtu.

Příklad:

"TATRSKBX"

autoPairingStrategy

enum<string>

Stratégia automatického párovania platieb pre tento účet.

Dostupné možnosti:

none,

by_variable_symbol,

by_price,

by_variable_symbol_and_price,

by_all_symbols,

by_all_symbols_and_price

Příklad:

"by_variable_symbol"

balance

number<float> | null

Posledný známy zostatok účtu, ak je dostupný z open banking napojenia.

Příklad:

1234.56

lastSyncedAt

string | null

Dátum a čas poslednej úspešnej synchronizácie účtu cez open banking, ak je dostupný.

Příklad:

"2026-03-01 10:15:16"

openBankingValidUntil

string<date> | null

Dátum, do ktorého je platný aktuálny open banking súhlas, ak existuje.

Příklad:

"2026-04-30"

createdAt

string | null

Dátum a čas vytvorenia bankového účtu.

Příklad:

"2026-03-03 12:00:00"

updatedAt

string | null

Dátum a čas poslednej zmeny bankového účtu.

Příklad:

"2026-03-03 15:45:00"

Předchozí

Upraviť bankový účetAktualizuje bankový účet. Pošlite len polia, ktoré chcete zmeniť. Ak pošlete `isPrimary: true`, účet sa nastaví ako primárny účet firmy.

Další

Detail bankového účtu

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 23,
    "name": "Tatra Banka",
    "swift": "TATRSKBX"
  },
  "isPrimary": true,
  "autoPaymentMatching": true,
  "name": "Hlavný účet",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "balance": 1234.56,
  "lastSyncedAt": "2026-03-01 10:15:16",
  "openBankingValidUntil": "2026-04-30",
  "createdAt": "2026-03-03 12:00:00",
  "updatedAt": "2026-03-03 15:45:00"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Prehľad

Endpointy

Detail bankového účtu

Autorizace

Parametry cesty

Odpověď