Skip to main content
GET
Get billing usage
Returns metered usage counters for the current billing period. Each counter tracks a billable resource and shows how much you have consumed relative to your plan limit.

Response

Returns an array of usage counter objects.
string
The usage metric identifier (e.g., attestations.mint, verifications_monthly, storage_bytes).
integer
Amount consumed in the current billing period.
integer
Maximum allowed for this metric under your plan. A value of -1 means unlimited.
string
Billing period for this counter: monthly or total.
string
Unit of measurement: count or bytes.
boolean
Whether the tenant is currently allowed to consume more of this metric. Returns false when the limit has been reached. Only included when relevant.
integer
Change in usage since the last query. Only included when the server tracks incremental updates.

Tracked metrics

The usage endpoint returns up to 16 metrics organized by product group. Which metrics appear depends on your plan and active features.

Core

MAIP (Machine Identity)

AI

Anti-Fraud

To check whether a specific operation is allowed before performing it, use the entitlements endpoint to verify your quotas.

Console dashboard

You can also view usage visually in the console at Settings > Billing > Usage. The dashboard shows all 16 metrics organized by product group (Core, MAIP, AI, and Anti-Fraud), each displayed as a progress bar against your plan limit. A projected monthly cost is calculated based on your current consumption and effective per-unit rates.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

period
string

Billing period (e.g. "2026-04")

Response

Usage data

period
string
usage
object