List accounting years

GET

/v1/accounting-years

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/accounting-years \
  -H "Authorization: Bearer numi_YOUR_API_KEY"

JavaScript

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

Response

200

{
  "accounting_years": [
    {
      "year": "2026",
      "start_date": "2026-01-01",
      "end_date": "2026-12-31",
      "is_closed": false
    }
  ]
}