List series
Return the list of label sets (unique metric identities) that match a set of series selectors. This is useful for discovering which time series exist for a given metric name or label combination.
At least one match[] argument must be provided. Each match[] value is a PromQL series selector (e.g. up, http_requests_total{method="GET"}). Multiple selectors are OR'd together — a series is returned if it matches any of the provided selectors.
Also accepts POST with a application/x-www-form-urlencoded body containing the same parameters.
Query parameters
Repeated series selector. At least one match[] argument must be provided. Each value is a PromQL series selector such as up{job="node"}. Multiple selectors are combined with logical OR.
Example: match[]=up&match[]=process_start_time_seconds{job="node"} returns series matching either selector.
Start timestamp to limit the time range of series considered. Only series with samples within [start, end] are returned. RFC 3339 or Unix seconds.
End timestamp to limit the time range of series considered. Only series with samples within [start, end] are returned. RFC 3339 or Unix seconds.
Maximum number of series to return. A value of 0 disables the limit. When omitted the server applies its default maximum.
Response
Array of label sets, one per matching series. Each label set is an object whose keys are label names and values are label values. The __name__ label contains the metric name.