Skip to main content
POST
Query a metrics timeseries
For selectors, fields, and series limits, see Querying metrics.

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>

Body

application/json

Query for fetching timeseries metric data, used to populate graphs.

from
string<date-time>
required

Start of the time range to query (inclusive).

to
string<date-time>
required

End of the time range to query (inclusive).

site_id
string
required

The site to fetch metrics for.

select
object[]
required

Selectors that define which metrics and fields to fetch.

resolution
null | enum<string>

The desired interval between data points. When None, a resolution is automatically chosen based on the time range.

Available options:
HOURLY,
MINUTELY,
DAILY
limit
integer<int32> | null

Maximum number of unique series to return. When None, no limit is applied.

Response

The matching series.

A collection of series over a time range, aligned to the given resolution.

resolution
enum<string>
required

The time interval between consecutive data points (e.g. one minute, one hour).

Available options:
HOURLY,
MINUTELY,
DAILY
from
string<date-time>
required

Start of the queried time range (inclusive).

to
string<date-time>
required

End of the queried time range (inclusive).

series
object[]
required

The individual timeseries that matched the query.