Skip to main content
GET
Usage dimension catalog
Returns every distinct usage dimension the authenticated tenant has ever reported via POST /v1/usage/events, with first/last seen timestamps and event counts. Dimensions are created implicitly — the first event that mentions api_calls adds api_calls to the catalog. Use this endpoint to discover what your services are actually reporting, or to populate dimension pickers in internal dashboards.

Example Request

Response

Naming a dimension identically to an entitlement feature_key (e.g. api_calls) lets GET /v1/subscriptions/{id}/usage join the entitlement’s limit in and report remaining headroom automatically.

Errors

Errors use the standard envelope — see Errors.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Response

Dimension catalog.

data
object[]