---
title: "Query a metric series"
method: POST
path: "/v1/data/metric-series"
tags: ["Data"]
---

# Query a metric series

`POST /v1/data/metric-series`

Returns a metric time series with advanced period and candidate filters.

## Request body

- MetricSeriesRequest
  - `resource` string, required
  - `key` string, required
  - `dealContext` string
  - `policy` string
  - `period` object

## Response `200`

The metric series.

- object
  - `data` DataSeries
    - `resource` string
    - `key` string
    - `points` object[]

## Other responses

- `400` — The request body or parameters are invalid.
- `401` — Missing or invalid API key credentials.

---

[API](https://skmtc.net/metal/apis/metal-api.md) · [All operations](https://skmtc.net/metal/apis/metal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metal/metal-api/revisions/afb7b675d5b2/schema)