Datadog · Schema

MetricTimeseriesQuery

Request body for querying timeseries metric data

AnalyticsDashboardsMonitoringPlatformT1Visualizations

Properties

Name Type Description
data object The query data object containing type and attributes
View JSON Schema on GitHub

JSON Schema

datadog-metrics-metric-timeseries-query-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-metrics-metric-timeseries-query-schema.json",
  "title": "MetricTimeseriesQuery",
  "description": "Request body for querying timeseries metric data",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "description": "The query data object containing type and attributes",
      "required": [
        "type",
        "attributes"
      ],
      "properties": {
        "type": {
          "type": "string",
          "description": "The type identifier for the query request",
          "enum": [
            "timeseries_request"
          ]
        },
        "attributes": {
          "type": "object",
          "description": "The query attributes including formulas, queries, and time range",
          "required": [
            "from",
            "to",
            "queries"
          ],
          "properties": {
            "from": {
              "type": "integer",
              "format": "int64",
              "description": "Unix timestamp in milliseconds for the start of the query time range"
            },
            "to": {
              "type": "integer",
              "format": "int64",
              "description": "Unix timestamp in milliseconds for the end of the query time range"
            },
            "interval": {
              "type": "integer",
              "format": "int64",
              "description": "The granularity (in milliseconds) for returned data points"
            },
            "queries": {
              "type": "array",
              "description": "List of metric queries to evaluate",
              "items": {
                "$ref": "#/components/schemas/MetricQueryDefinition"
              }
            },
            "formulas": {
              "type": "array",
              "description": "List of formula expressions combining the defined queries",
              "items": {
                "$ref": "#/components/schemas/QueryFormula"
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "data"
  ]
}