Saved bank accounts · Myntkaup API

The bank accounts the account has withdrawn to before, most recently used first. A bank withdrawal can go to one of these or to a new account.

Scope: account:read or withdrawals:create
Rate-limit class: read
Authentication: Signed

Responses

200 OK

The saved bank accounts. application/json · BankAccountList

dataarray of BankAccount
4 properties of each item
- account_numberstring
- payout_currencystring (enum)
  How Myntkaup pays out to this account; nothing to choose. ISK: in krónur at Arion's rate. FOREIGN: an Arion foreign-currency account (ledger 38), in US dollars.
  One of ISK, FOREIGN.
- added_atstring (date-time)nullable
- last_used_atstring (date-time)nullable

Every response carries MK-Request-Id, plus RateLimit-Policy and RateLimit.

Errors

Errors use the error envelope. Match on code.

Status	Code	Meaning
400	`invalid_request`	The request is malformed: bad JSON, an unknown or invalid field, or a missing header.
401	`invalid_signature`	The MK-* headers are missing or malformed, the key id is unknown, or the signature doesn't match.
401	`key_expired`	The key has passed its expiry date.
401	`key_revoked`	The key was revoked.
401	`timestamp_out_of_range`	MK-Timestamp is more than 30 seconds from the server clock.
401	`nonce_reused`	This key already used this MK-Nonce.
403	`ip_not_allowed`	The request came from an address outside the key's IP allowlist.
403	`insufficient_scope`	The key doesn't have the scope this endpoint needs.
403	`account_restricted`	The account can't use the API right now (for example locked, inactive, or onboarding not finished).
403	`api_access_disabled`	API access is switched off.
429	`rate_limited`	Too many requests. Wait for Retry-After seconds.
429	`too_many_concurrent_requests`	Too many requests in flight for this key or account.
429	`key_suspended`	The key is suspended, for example after sustained rate limiting.
500	`internal_error`	Something went wrong on our side.
502	`bad_gateway`	An upstream service answered unexpectedly.
503	`overloaded`	The service is overloaded. Retry after Retry-After seconds.
503	`service_unavailable`	The service is temporarily unavailable.
504	`gateway_timeout`	An upstream service didn't answer in time. A POST may still complete; retry with the same 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"
    }
  ]
}

Base URL https://public-api.myntkaup.is