API

GET /metrics/{id}/history

Aggregated metric values over a window (max 30 days)

Updated 1 mo ago

Parameters#

Name	In	Required	Type	Description
`id`	path	yes	string
`from`	query	yes	string
`to`	query	no	string
`resolution`	query	no	string

Example request#

curl -X GET "/api/v1/metrics/{id}/history" \
  -H "Authorization: Bearer YOUR_API_KEY"

Responses#

200: ok#

{
  "resolution": "1m",
  "from": "2026-01-01T00:00:00.000Z",
  "to": "2026-01-01T00:00:00.000Z",
  "items": [
    {
      "bucket": "2026-01-01T00:00:00.000Z",
      "avg_value": null,
      "max_value": null,
      "min_value": null,
      "sample_count": 0
    }
  ]
}

400: invalid range / resolution#

401: missing or invalid bearer token#

403: missing required scope#

404: not found (or cross-tenant: same response)#

429: rate limit exceeded#

Was this page helpful?