Billing
List Usage for Month
Get detailed usage charges for a specific calendar month
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
API key or Cognito JWT:
Bearer sk-xxxxxxQuery Parameters
Four-digit year (for example,
2026).Month number from 1 to 12.
Maximum number of items to return (minimum 1).
Number of items to skip for pagination.
Response
Same shape as List Usage: a paginatedUsageListResponse with items, total, limit, offset, and has_more.
For arbitrary date ranges, use List Usage with
from and to query parameters instead.
