Months
Which months have budgets (for the month picker, NAV-2)
Required scope: `budget:read` (personal access tokens; sessions have every scope).
Required scope: budget:read (personal access tokens; sessions have every scope).
Authorization
bearerAuth AuthorizationBearer <token>
Authorization: Bearer <token>: a mobile session token, or a personal access token
(srp_…) created in Account → API tokens (DEV-1).
Personal access tokens:
- Act as their user. The household comes from
X-SpendRock-Household, else the user's default. - Carry scopes (DEV-2), and each operation's description names the one it needs:
budget:read/budget:write(months, groups, items, funds, favorites, harvest),transactions:read/transactions:write(transactions, merchant suggestions),households:read/households:manage(households, members, invites),account:read/account:write(me, settings). A write scope includes its read scope. A call outside the token's scopes gets 403insufficient_scope, with the needed scope indetails.required_scope. - Can't manage tokens or passwords (403
session_required). - May expire (401
unauthenticatedafterwards). - Are rate-limited (DEV-3): 120 requests/minute per token with bursts up to 120. Every
response carries
X-RateLimit-Limit,X-RateLimit-Remaining, andX-RateLimit-Reset(seconds until the bucket is full again); over the limit the answer is 429rate_limitedwithRetry-After(seconds). Limits are kept per server instance, so they're approximate.
Sessions (web cookie or mobile bearer) have every scope and aren't limited this way. Cross-origin browser calls (CORS, for the API docs playground) must use a bearer token; cookies are never accepted cross-origin.
In: header
Query Parameters
from*string
Match
^[0-9]{4}-(0[1-9]|1[0-2])$to*string
Match
^[0-9]{4}-(0[1-9]|1[0-2])$Header Parameters
X-SpendRock-Household?string
The household to act on (HH-12). Defaults to the user's default household. 403 not_a_member if the caller isn't a current member (HH-16).
Match
^[0-9A-HJKMNP-TV-Z]{26}$Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/months?from=2026-12&to=2026-12"{ "months": [ { "month": "2026-12", "exists": true } ]}