/usage/events

List the tenant's individual usage events of one billing month (Europe/Berlin calendar month, default the current one), newest first: meter, credits, outcome, the record each event was metered for, and who caused it (user, API key, agent, or unattributed). Optionally filtered to one meter, cursor-paginated. Events are served for the last 24 months; older months return an empty page.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
^\d{4}-(0[1-9]|1[0-2])$

Billing month to list, "YYYY-MM" (Europe/Berlin). Defaults to the current billing month. Months more than 24 months back return an empty page.

string
enum

Only return events of this meter. Omit for all meters.

Allowed:
string

Opaque pagination cursor returned in the previous response's cursors.after. Pass through verbatim.

integer
1 to 500

Maximum number of events to return in one page (1-500). Defaults to 100.

Responses

400

Bad request

401

Unauthorized

403

The role of the API key does not allow this action. The key needs a role with the matching permission, for example full access.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json