API referenceGenerated
Usage Breakdown
Top event consumers over the last N days (top-20 + 'other'). Breakdown dimensions live on otel.span_node (every ingested span — the validated default meter source); with a non-span meter source the shares are indicative. api_key groups by the gateway-stamped key_id (resource attribute); spans ingested before stamping fall into 'unattributed'.
Authorization
HTTPBearer AuthorizationBearer <token>
In: header
Query Parameters
group_by?Group By
Default
"agent"Value in
- "agent"
- "feature"
- "api_key"
days?Days
Range
1 <= value <= 90Default
30Response Body
application/json
application/json
curl -X GET "https://example.com/usage/breakdown"[ { "key": "string", "label": "string", "events": 0, "pct": 0 }]{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}