Retrieve the organization's credit position for each of its billing periods, newest first — the same figures GET /v1/credits/usage returns, one entry per period, for building period-over-period tracking on your side.

The period still open carries isCurrent: true and matches GET /v1/credits/usage exactly; starting a walk with no cursor, that is the first entry of the first page. Every entry whose period has already ended is closed and its usage figures are final.

History reaches back to the organization's first recorded day of credit usage — there is no fixed retention cutoff, so the number of periods available grows with the age of the account. Pass cursor to page further back; nextCursor is null once the oldest recorded period has been returned.

One caveat on the allowance fields (planIncludedCredits, complimentaryCredits, includedCredits, overageLimitCredits): they reflect the organization's plan configuration as it stands today, not as it stood during a past period. Runbear does not snapshot plan configuration per period. currentUsageCredits is the field that is genuinely historical, and overageCreditsUsed is derived from it against today's allowance.