Observer
API

GET /metrics/{id}/history

Aggregated metric values over a window (max 30 days)

Parameters

NameInRequiredTypeDescription
idpathyesstring
fromqueryyesstring
toquerynostring
resolutionquerynostring

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?