List accounts

GET

/v1/accounts

Returns the company's whole chart of accounts, not paginated. Headings and subtotals are included; only profitAndLoss and status accounts can be posted to.

Requires one ofsetup: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/accounts \
  -H "Authorization: Bearer numi_YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.numina.app/v1/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/accounts",
    headers={
        "Authorization": f"Bearer {os.environ['NUMINA_API_KEY']}",
    },
)
data = response.json()

Response

200

{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "account_number": 3000,
      "name": "Revenue",
      "description": "Revenue from sales",
      "account_type": "profitAndLoss",
      "default_vat_code": "U25"
    }
  ]
}