GET /metrics/{id}/history
Aggregated metric values over a window (max 30 days)
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?