Find time series

GET 
/series

Returns the list of time series that match a certain label set. At least one match[] parameter must be provided.

This endpoint returns one entry per matching metric name; each entry contains only the __name__ label, for example {"__name__": "reliability"}. It lists the public-schema metrics that match the selectors — it does not enumerate the distinct project, slo, objective, and service label combinations that exist as individual series, and it does not read stored data.

warning

To list concrete label values such as projects, SLOs, and services, use /label/{label_name}/values.

Request

Responses

200

Successful series retrieval

400

Bad request — invalid or unparseable parameters (for example, a malformed PromQL expression or timestamp), or a query that exceeds the query limits (too many series, time range too long, or too many result points). Returned as a Prometheus-style JSON error with errorType: bad_data.

401

Unauthorized — missing or invalid authentication. Triggered when the Authorization header is absent or the access key (Client ID / Client Secret) is invalid. Returned as a plain-text body, for example missing Authorization request header.

500

Internal server error — an unexpected failure while resolving metrics or executing the query. Returned as a Prometheus-style JSON error.