Get financial period details

GET https://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

id string required

Response

200 Default Response

Show response fields

closedAt string nullable

id integer

label string

netProfit string nullable

status string

totalExpenses string nullable

totalRevenue string nullable

yearEnd string

yearStart string

Error codes

404 Default Response

Request GET /v1/reports/periods/{id} curl

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

Response 200

{
  "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
  }
}