Skip to main content
GET
/
api
/
v1
/
series
List series
curl --request GET \
  --url http://localhost:9090/api/v1/series
{
  "status": "success",
  "data": [
    {
      "__name__": "up",
      "job": "node",
      "instance": "localhost:9100"
    }
  ]
}

Query Parameters

​
match[]
string[]

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
string

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
string

End timestamp to limit the time range of series considered. Only series with samples within [start, end] are returned. RFC 3339 or Unix seconds.

​
limit
integer

Maximum number of series to return. A value of 0 disables the limit. When omitted the server applies its default maximum.

Required range: x >= 0

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.

Response for the series listing endpoint (/api/v1/series). On success, data contains an array of label sets — one object per matching time series.

​
status
enum<string>
required
Available options:
success,
error
​
data
object[]

Array of label sets, one per matching series. Each object is a map of label names to label values. The __name__ label contains the metric name.

​
error
string

Human-readable error message (present when status is error).

​
errorType
string

Error category (present when status is error).