Skip to main content
GET
Get usage /v2

Authorizations

Authorization
string
header
required

Authorization: Bearer <YOUR_API_KEY>. The Bearer prefix is optional.

Query Parameters

num_billing_periods
integer
default:1

How many billing periods to return, newest first. Cannot be used with id.

Required range: 1 <= x <= 100
id
integer<int64>

The billing period to check. Get an id from List billing periods. Cannot be combined with pagination.

Required range: x >= 1
cursor
string

Use next_cursor from the previous response to get the next page.

Response

Usage for the selected periods. Selecting an id still returns a data array.

customer_name
string
required

The authenticated account.

data
object[]
required
next_cursor
string | null
required

Pass as cursor for the next page. null means there are no more periods.