List bank accounts

GET

/v1/bank-accounts

The company's connected bank accounts and, when it has typed in payment details for a bank that is not connected, one manual account. Use it to choose where an invoice is paid (bank_account_id on POST /v1/invoices) and to filter bank lines. Not paginated.

Requires one ofbank:read read:ledger

Errors

401Invalid or missing authentication
403Missing scope, or the company is archived
429Rate limit exceeded
500Internal Server Error

Every error has the same shape. See Errors.

cURL

curl https://api.numina.app/v1/bank-accounts \
  -H "Authorization: Bearer numi_YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.numina.app/v1/bank-accounts", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.NUMINA_API_KEY}`,
  },
});

const data = await response.json();

Python

import os

import requests

response = requests.get(
    "https://api.numina.app/v1/bank-accounts",
    headers={
        "Authorization": f"Bearer {os.environ['NUMINA_API_KEY']}",
    },
)
data = response.json()

Response

200

{
  "bank_accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "connected",
      "bank_name": "Danske Bank",
      "account_name": "Erhvervskonto",
      "ledger_account_number": 5820,
      "connection_status": "configured",
      "is_archived": false,
      "payment_details": {
        "bank_name": "Danske Bank",
        "scheme": "dk-registration-number",
        "clearing_code": "3409",
        "account_number": "0012345678",
        "iban": "DK5030000012345678",
        "swift_bic": "DABADKKK"
      },
      "usable_on_invoices": false,
      "is_invoice_default": false
    }
  ]
}