Bankové účty

Read-only zoznam bankových účtov organizácie.

Bankové účty tvojej organizácie. Endpoint je read-only – účty pridáš v UI Nastavenia → Bankové účty. API ich vystavuje aby si vedel zostaviť snapshoty pri vytváraní dokumentov a filtrovať platobné údaje podľa meny. Detail účtu (GET podľa id) vracia navyše polia bank_code, account_number a updated_at, ktoré v zozname nie sú.

Endpointy

GET/api/v1/bank-accountsbank_accounts:read

Zoznam bankových účtov organizácie.

Request

curl "https://monivio.sk/api/v1/bank-accounts" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": [
    {
      "id": "bac_2hf8pq3rxn4mlkzyt9abwvve",
      "version": 1,
      "name": "Hlavný účet EUR",
      "iban": "SK68 0900 0000 0001 2345 6789",
      "swift": "GIBASKBX",
      "currency": "EUR",
      "is_default": true,
      "is_active": true,
      "created_at": "2026-04-15T10:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "total_pages": 1
  }
}

GET/api/v1/bank-accountsbank_accounts:read

Filter podľa meny – vráti len účty v danej mene (ISO 4217 kód, napr. EUR, USD, CZK).

Request

curl "https://monivio.sk/api/v1/bank-accounts?currency=EUR" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": [
    {
      "id": "bac_2hf8pq3rxn4mlkzyt9abwvve",
      "version": 1,
      "name": "Hlavný účet EUR",
      "iban": "SK68 0900 0000 0001 2345 6789",
      "swift": "GIBASKBX",
      "currency": "EUR",
      "is_default": true,
      "is_active": true,
      "created_at": "2026-04-15T10:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "total_pages": 1
  }
}

GET/api/v1/bank-accounts/{bankAccountId}bank_accounts:read

Detail účtu. Vracia všetky polia zo zoznamu plus bank_code, account_number a updated_at.

Request

curl "https://monivio.sk/api/v1/bank-accounts/bnk_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": {
    "id": "bac_2hf8pq3rxn4mlkzyt9abwvve",
    "version": 1,
    "name": "Hlavný účet EUR",
    "iban": "SK68 0900 0000 0001 2345 6789",
    "swift": "GIBASKBX",
    "currency": "EUR",
    "is_default": true,
    "is_active": true,
    "created_at": "2026-04-15T10:00:00.000Z",
    "bank_code": "0900",
    "account_number": "0001234567",
    "updated_at": "2026-04-15T10:00:00.000Z"
  }
}

Objekt BankAccount

idreadonly

string

Stabilný CUID2 identifikátor účtu s prefixom bac_.

Príklad: bac_2hf8pq3rxn4mlkzyt9abwvve

versionreadonly

number

Číslo aktuálnej verzie účtu. Pri každej úprave (cez UI) sa zvýši o 1.

Príklad: 1

name

string

Označenie účtu pre interné použitie (napr. „Hlavný účet EUR“, „Rezervný USD“).

Príklad: Hlavný účet EUR

iban

string/ null

IBAN s medzerami pre čitateľnosť. Voliteľné – účet môže existovať aj bez IBAN-u (napr. pri zahraničných účtoch s lokálnym account_number).

Príklad: SK68 0900 0000 0001 2345 6789

swift

string/ null

SWIFT/BIC kód banky.

Príklad: GIBASKBX

currency

string (ISO 4217)

Mena účtu. Použite na filtrovanie cez query parameter ?currency=EUR.

Príklad: EUR

is_default

boolean

Default účet – použije sa pri vytváraní dokumentu, ak rad neuvádza vlastný účet.

is_activereadonly

boolean

Či je účet aktívny. API vracia iba aktívne účty (soft-deleted sa do zoznamu nedostanú), takže hodnota je vždy true.

bank_code

string/ null

Lokálny kód banky (napr. „0900“ pre SLSP). Iba v detaile účtu – v zozname tento údaj nie je.

Príklad: 0900

account_number

string/ null

Lokálne číslo účtu bez IBAN-u. Iba v detaile účtu – v zozname tento údaj nie je.

Príklad: 0001234567

created_atreadonly

string (ISO 8601)

Kedy bol účet pridaný do organizácie.

updated_atreadonly

string (ISO 8601)

Posledná zmena účtu. Iba v detaile účtu – v zozname tento údaj nie je.