Vistaðir bankareikningar

Bankareikningar sem aðgangurinn hefur áður tekið út á, síðast notaði fyrst. Bankaúttekt getur farið á einn þeirra eða á nýjan reikning.

Heimild: account:read eða withdrawals:create
Takmarkaflokkur: read
Auðkenning: Undirrituð

Svör

200 OK

Vistuðu bankareikningarnir. application/json · BankAccountList

datafylki af BankAccount
4 reitir í hverju staki
- account_numberstring
- payout_currencystring (enum)
  Hvernig Myntkaup greiðir út á þennan reikning; ekkert þarf að velja. ISK: í krónum á gengi Arion banka. FOREIGN: gjaldeyrisreikningur í Arion banka (höfuðbók 38), í Bandaríkjadölum.
  Eitt af ISK, FOREIGN.
- added_atstring (date-time)getur verið null
- last_used_atstring (date-time)getur verið null

Öll svör bera MK-Request-Id, auk RateLimit-Policy og RateLimit.

Villur

Villur nota villuumslagið. Greindu þær eftir code.

Staða	Kóði	Merking
400	`invalid_request`	Beiðnin er gölluð: ógilt JSON, óþekktur eða ógildur reitur, eða haus vantar.
401	`invalid_signature`	`MK-*` hausana vantar eða þeir eru gallaðir, auðkenni lykilsins er óþekkt eða undirskriftin passar ekki.
401	`key_expired`	Gildistími lykilsins er liðinn.
401	`key_revoked`	Lykillinn var afturkallaður.
401	`timestamp_out_of_range`	`MK-Timestamp` munar meira en 30 sekúndum frá klukku netþjónsins.
401	`nonce_reused`	Þessi lykill hefur þegar notað þetta `MK-Nonce`.
403	`ip_not_allowed`	Beiðnin kom frá IP tölu sem er ekki meðal leyfðra IP talna lykilsins.
403	`insufficient_scope`	Lykilinn vantar heimildina sem þessi endapunktur þarf.
403	`account_restricted`	Aðgangurinn getur ekki notað API-ið eins og er (til dæmis læstur, óvirkur eða nýskráningu ólokið).
403	`api_access_disabled`	Slökkt er á aðgangi að API-inu.
429	`rate_limited`	Of margar beiðnir. Bíddu í `Retry-After` sekúndur.
429	`too_many_concurrent_requests`	Of margar beiðnir í vinnslu í einu fyrir þennan lykil eða aðgang.
429	`key_suspended`	Lykillinn er stöðvaður, til dæmis eftir að hafa farið ítrekað yfir beiðnatakmörk.
500	`internal_error`	Eitthvað fór úrskeiðis hjá okkur.
502	`bad_gateway`	Undirliggjandi þjónusta svaraði á óvæntan hátt.
503	`overloaded`	Þjónustan er undir of miklu álagi. Reyndu aftur eftir `Retry-After` sekúndur.
503	`service_unavailable`	Þjónustan er tímabundið ekki tiltæk.
504	`gateway_timeout`	Undirliggjandi þjónusta svaraði ekki í tæka tíð. `POST` beiðni gæti samt klárast; reyndu aftur með sama `Idempotency-Key`.

# Signed by sign-headers.sh: see Authentication
curl https://public-api.myntkaup.is/v1/bank-accounts \
  $(./sign-headers.sh GET /v1/bank-accounts | sed 's/^/-H /')

import { Myntkaup } from "@myntkaup/api";

const client = new Myntkaup(); // reads the key from the environment
const { data: accounts } = await client.bankAccounts.list();
console.log(accounts.map((account) => account.account_number));

from myntkaup import Myntkaup

client = Myntkaup()  # reads the key from the environment
accounts = client.bank_accounts.list()["data"]
print([account["account_number"] for account in accounts])

200 OK

{
  "data": [
    {
      "account_number": "0133-26-012345",
      "payout_currency": "ISK",
      "added_at": "2026-03-02T14:05:00Z",
      "last_used_at": "2026-10-28T09:12:00Z"
    }
  ]
}

Grunnslóð https://public-api.myntkaup.is