List financial periods

GET https://app.speybooks.com/api/v1/reports/periods

Returns all financial periods for the organisation in reverse chronological order. Periods define fiscal year boundaries and track whether the year is open or closed.

Closed periods include summary figures (revenue, expenses, net profit) computed at close time.

Response

200 Default Response

Show response fields

periods array<object>

Show child attributes

id integer

label string

status string

yearEnd string

yearStart string

Request GET /v1/reports/periods curl

curl https://api.speybooks.com/v1/reports/periods \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "periods": [
      {
        "id": 1,
        "label": "2025/26",
        "yearStart": "2025-04-06",
        "yearEnd": "2026-04-05",
        "status": "open"
      }
    ]
  }
}