---
title: "Performs a label set lookup"
method: GET
path: "/series/labels"
tags: ["SCALABLE TIME SERIES"]
---

# Performs a label set lookup

`GET /series/labels`

This command operates in one of three modes.

It can perform a label set lookup for one or more time series identifiers, when given the series parameter. The JSON response for this mode contains the same information as the **pmseries - I /-- labels** option.
```bash
$ curl -s http://localhost:44322/series/labels?series=605fc77742cd0317597291329561ac4e50c0dd12 | pmjson
```
It can produce a list of all known label names, in the absence of name , names or series parameters. The JSON responses for this mode contains the same information as the **pmseries - l /-- labels** option.        
```bash
$ curl -s http://localhost:44322/series/labels | pmjson
```
It can produce a list of all known label values for a given label name or names . The JSON response for this mode contains the same information as the **pmseries - v /-- values** option.
```bash
$ curl -s http://localhost:44322/series/labels?names=hostname,domainname | pmjson
```
**References:** [pmSeriesLabels](https://man7.org/linux/man-pages/man3/pmSeriesLabels.3.html)(3), [pmSeriesLabelValues](https://man7.org/linux/man-pages/man3/pmSeriesLabelValues.3.html)(3)

## Query parameters

- `series` string
- `match` string
- `name` string
- `names` string
- `client` string

## Response `200`

OK

## Changes

> 16 revisions in range; 4 could not be searched.

- **2020-10-20** `22da063d564f` — 2 info
  - added `#/components/schemas/seriesParam, #/components/schemas/noParam, #/components/schemas/namesParam` to the response body `anyOf` list for the response status `200`
  - removed `#/components/schemas/response3, #/components/schemas/response4, #/components/schemas/response5` from the response body `anyOf` list for the response status `200`
- **2020-10-20** `7da0633fad91` — 2 info
  - added `#/components/schemas/response3, #/components/schemas/response4, #/components/schemas/response5` to the response body `anyOf` list for the response status `200`
  - removed `#/components/schemas/seriesParam, #/components/schemas/noParam, #/components/schemas/namesParam` from the response body `anyOf` list for the response status `200`

[Change history](https://skmtc.dev/performancecopilot/apis/pmwebapi/changes/series/labels/get.md)

---

[API](https://skmtc.dev/performancecopilot/apis/pmwebapi.md) · [All operations](https://skmtc.dev/performancecopilot/apis/pmwebapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/performancecopilot/pmwebapi/revisions/666212c8ed6b/schema)