Update bank account

PATCH

bank-accounts

{bankAccount}

Update bank account

curl --request PATCH \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bankId": 1,
  "name": "Main account",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_price",
  "isPrimary": true
}
'

import requests

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

payload = {
    "bankId": 1,
    "name": "Main account",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "autoPairingStrategy": "by_price",
    "isPrimary": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    bankId: 1,
    name: 'Main account',
    iban: 'SK3111000000001234567890',
    swift: 'TATRSKBX',
    autoPairingStrategy: 'by_price',
    isPrimary: true
  })
};

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 => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'bankId' => 1,
    'name' => 'Main account',
    'iban' => 'SK3111000000001234567890',
    'swift' => 'TATRSKBX',
    'autoPairingStrategy' => 'by_price',
    'isPrimary' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"bankId\": 1,\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"autoPairingStrategy\": \"by_price\",\n  \"isPrimary\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bankId\": 1,\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"autoPairingStrategy\": \"by_price\",\n  \"isPrimary\": true\n}")
  .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::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"bankId\": 1,\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"autoPairingStrategy\": \"by_price\",\n  \"isPrimary\": true\n}"

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": "Main account",
  "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"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

bankAccount

integer

required

Bank account ID.

Example:

201

Body

application/json

Payload used to update a bank account. Send only the fields you want to change. Fields you omit keep their current value.

bankId

integer | null

Optional bank ID from the banks lookup endpoint. Send null if you want to remove the bank link.

Example:

1

name

string

New bank account name.

Maximum string length: 255

Example:

"Main account"

iban

string

New IBAN of the bank account. It must remain valid and unique within the token scope.

Example:

"SK3111000000001234567890"

swift

string

New SWIFT or BIC code of the bank account.

Maximum string length: 255

Example:

"TATRSKBX"

autoPairingStrategy

enum<string>

New automatic payment pairing strategy for this account. If omitted, the existing value stays unchanged.

Available options:

none,

by_variable_symbol,

by_price,

by_variable_symbol_and_price,

by_all_symbols,

by_all_symbols_and_price

Example:

"by_price"

isPrimary

boolean

Send true if this account should become the company's primary account. Omitting the field or sending false keeps the current primary assignment unchanged and does not turn the account into a non-primary one.

Example:

true

Response

Bank account updated.

Bank account. This object combines the business account fields, bank details, and open banking state.

integer

Internal Fintoro bank account ID.

Example:

201

bankId

integer | null

Bank ID from the banks lookup endpoint. If null, the account is not linked to a known bank from the public lookup.

Example:

1

bank

object | null

Nested bank object corresponding to bankId, when the bank is known and still available in the lookup dataset.

Show child attributes

isPrimary

boolean

Indicates whether this account is currently marked as the company's primary bank account.

Example:

true

autoPaymentMatching

boolean

Indicates whether the account is currently connected to automatic payment matching through open banking. This value is derived from the presence of an open banking connection and is never sent in the request payload.

Example:

true

name

string

User-facing bank account name shown in Fintoro.

Example:

"Main account"

iban

string

Bank account IBAN.

Example:

"SK3111000000001234567890"

swift

string

SWIFT or BIC code of the bank account.

Example:

"TATRSKBX"

autoPairingStrategy

enum<string>

Automatic payment pairing strategy used for this bank account.

Available options:

none,

by_variable_symbol,

by_price,

by_variable_symbol_and_price,

by_all_symbols,

by_all_symbols_and_price

Example:

"by_variable_symbol"

balance

number<float> | null

Last known account balance, when available from open banking.

Example:

1234.56

lastSyncedAt

string | null

Date and time of the last successful open banking sync, when available.

Example:

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

openBankingValidUntil

string<date> | null

Date until which the current open banking consent remains valid, if present.

Example:

"2026-04-30"

createdAt

string | null

Date and time when the bank account was created.

Example:

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

updatedAt

string | null

Date and time of the most recent bank account change.

Example:

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

Update bank account

curl --request PATCH \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bankId": 1,
  "name": "Main account",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_price",
  "isPrimary": true
}
'

import requests

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

payload = {
    "bankId": 1,
    "name": "Main account",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "autoPairingStrategy": "by_price",
    "isPrimary": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    bankId: 1,
    name: 'Main account',
    iban: 'SK3111000000001234567890',
    swift: 'TATRSKBX',
    autoPairingStrategy: 'by_price',
    isPrimary: true
  })
};

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 => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'bankId' => 1,
    'name' => 'Main account',
    'iban' => 'SK3111000000001234567890',
    'swift' => 'TATRSKBX',
    'autoPairingStrategy' => 'by_price',
    'isPrimary' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"bankId\": 1,\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"autoPairingStrategy\": \"by_price\",\n  \"isPrimary\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://app.fintoro.sk/api/public/v1/bank-accounts/{bankAccount}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"bankId\": 1,\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"autoPairingStrategy\": \"by_price\",\n  \"isPrimary\": true\n}")
  .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::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"bankId\": 1,\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"autoPairingStrategy\": \"by_price\",\n  \"isPrimary\": true\n}"

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": "Main account",
  "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"
}

Overview

Endpoints

Authorizations

Path Parameters

Body

Response