Get financial period details

GEThttps://app.speybooks.com/api/v1/reports/periods/{id}

Returns detailed information about a specific financial period including closing balances (if closed), the closing transaction reference, and computed P&L figures. Period ID is a plain integer, not prefixed.

Path parameters

idstringrequired

Response

200Default Response

Show response fields

closedAtstringnullable

idinteger

labelstring

netProfitstringnullable

statusstring

totalExpensesstringnullable

totalRevenuestringnullable

yearEndstring

yearStartstring

Error codes

404Default Response

RequestGET/v1/reports/periods/{id}curl

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

Response200

{
  "success": true,
  "data": {
    "id": 1,
    "label": "2025/26",
    "yearStart": "2025-04-06",
    "yearEnd": "2026-04-05",
    "status": "open",
    "closedAt": null,
    "totalRevenue": null,
    "totalExpenses": null,
    "netProfit": null
  }
}