---
title: "POST /v3/{+name}/timeSeries:query"
method: POST
path: "/v3/{+name}/timeSeries:query"
tags: ["projects"]
---

# POST /v3/{+name}/timeSeries:query

`POST /v3/{+name}/timeSeries:query`

Queries time series by using Monitoring Query Language (MQL). We recommend using PromQL instead of MQL. For more information about the status of MQL, see the MQL deprecation notice (https://cloud.google.com/stackdriver/docs/deprecations/mql).

## Path parameters

- `name` string, required

## Request body

- QueryTimeSeriesRequest — The QueryTimeSeries request. For information about the status of Monitoring Query Language (MQL), see the MQL deprecation notice (https://cloud.google.com/stackdriver/docs/deprecations/mql).
  - `query` string — Required. The query in the Monitoring Query Language (https://cloud.google.com/monitoring/mql/reference) format. The default time zone is in UTC.
  - `pageSize` integer — A positive number that is the maximum number of time_series_data to return.
  - `pageToken` string — If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/monitoring.md) · [All operations](https://skmtc.net/google/apis/monitoring/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/monitoring/versions/11ce0f8d9e4c/schema)