Skip to main content
GET
Get a paginated list of posted usage charges for a specific calendar month. This is a convenience endpoint equivalent to List Usage with a from/to date range scoped to one month. Use this when building monthly reports or billing dashboards.

Headers

Authorization
string
required
API key or Cognito JWT: Bearer sk-xxxxxx

Query Parameters

year
integer
required
Four-digit year (for example, 2026).
month
integer
required
Month number from 1 to 12.
limit
integer
default:"50"
Maximum number of items to return (minimum 1).
offset
integer
default:"0"
Number of items to skip for pagination.

Response

Same shape as List Usage: a paginated UsageListResponse with items, total, limit, offset, and has_more.
For arbitrary date ranges, use List Usage with from and to query parameters instead.