List financial periods

GEThttps://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, closed, or locked (locked reserved, no current API path).

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

Response

200Default Response

Show response fields

periodsarray<object>

Show child attributes

idinteger

labelstring

statusstring

yearEndstring

yearStartstring

RequestGET/v1/reports/periodscurl

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

Response200

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