Read daily spend over a window
Spend per day over the last `days` days, with a category breakdown for the current month and a projection of where the month lands.
/v1/workspace/billing/timeseriesAdmin- Operation id
- billing_timeseries
- Access
- An editor or a viewer is refused.
/v1/workspace/billing/timeseriesSpend per day over the last days days, with a category breakdown for
the current month and a projection of where the month lands.
days is 1 to 180 and defaults to 30. Every day in the window is present,
including days with no spend, which report zero. That is what makes the
series safe to chart without filling gaps yourself.
The month-end figure is a straight-line projection from spend so far. It is an estimate, not a commitment, and it says nothing about what anyone is charged.
Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.
Authorisation: admin or owner. An editor or viewer receives 403 insufficient_role.
Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the workspace-admin:write scope, and the workspace role of the person who owns it must meet the floor above.
A realm-issued access token, presented as Authorization: Bearer <token>. It acts as the person who signed in, and every operation resolves their workspace role live from the membership record.
In: header
Query Parameters
1 <= value <= 18030Response Body
application/json
application/json
curl -X GET "https://example.com/v1/workspace/billing/timeseries"{}