UsageSeries

One measure over time, in UTC buckets, optionally split by a dimension into the largest groups and one “other” series.

Kind: an object, used in responses.

Fields

Every field is present in a response; empty ones are null.

Field	Type	Description
from	datetime	The start of the range, in UTC.
to	datetime	The end of the range, in UTC.
bucket	string	The bucket size: hour, day or week.
metric	string	The measure.
groupBy	string | null	The dimension the series are split by, or null for one total series.
buckets	datetime[]	Every bucket’s start (UTC), including empty ones; each series’ values line up with these.
series	UsageSeriesLine[]	The series.

Example

{
  "from": "2026-10-26T12:00:00.0000000Z",
  "to": "2026-10-26T12:00:00.0000000Z",
  "bucket": "...",
  "metric": "...",
  "groupBy": "...",
  "buckets": [
    "2026-10-26T12:00:00.0000000Z"
  ],
  "series": [
    {
      "key": "...",
      "label": "...",
      "detail": "...",
      "isOther": false,
      "total": 0,
      "values": []
    }
  ]
}

Where it’s used

• usage.series (GET /usage/series)