Get metric data

GET

Returns a list of datapoints and corridors for a single metric over a requested time range.

Data availability

Metric datapoints and corridors from this endpoint are available only after Eyer has collected enough data to start building baselines. In most cases, this happens within 7 days after ingestion begins.

Range limits

Requests can span up to 14 days. If you request 1m granularity for a metric stored at 1m source granularity, the request is limited to 48 hours.

Path parameters

Parameter	Type	Description
node-id	integer	Required node identifier for the metric series to fetch
metric-id	string	Required metric identifier for the metric series to fetch

Query parameters

Parameter	Type	Description
from	ISO 8601 datetime	Optional lower bound of the requested time range. If from and to are not provided, the API defaults to the last 15 minutes.
to	ISO 8601 datetime	Optional upper bound of the requested time range. The time window between from and to cannot exceed 14 days.
aggregation	string	Optional aggregation to use for the response. Supported values: avg, max, sum. If omitted, the API resolves the metric aggregation automatically.
granularity	string	Optional response granularity. Supported values: 1m, 15m, 60m, 1h. If omitted, the API selects granularity automatically: up to 12h returns 1m, more than 12h up to 7d returns 15m, and more than 7d returns 60m.

Response

• 200 OK

The response is a Metric data response object.

The response includes the resolved aggregation, the returned granularity, and the underlying sourceGranularity used to build the series.

When corridor data is available, each corridor band is returned with up and down values. sup and inf can be null when those bands are not present.

{
  "node": 10,
  "metric": "2b953ac0-f047-45e0-a8e4-bc66e0593eff",
  "aggregation": "avg",
  "granularity": "15m",
  "sourceGranularity": "1m",
  "data": [
    {
      "timestamp": 1763035200000,
      "smoothened": 42.1,
      "corridors": {
        "main": {
          "up": 45.3,
          "down": 39.4
        },
        "sup": {
          "up": 47.8,
          "down": 37.1
        },
        "inf": {
          "up": 43.6,
          "down": 40.8
        }
      }
    }
  ]
}

Errors

• 400: invalid or missing parameters, unsupported granularity, or a time range that exceeds the allowed limit
• 401: unauthorized
• 403: forbidden

Examples

• GET /v1/ad/metrics/10/2b953ac0-f047-45e0-a8e4-bc66e0593eff?from=2026-04-01T00:00:00Z&to=2026-04-08T00:00:00Z
• GET /v1/ad/metrics/10/2b953ac0-f047-45e0-a8e4-bc66e0593eff?from=2026-04-08T00:00:00Z&to=2026-04-08T12:00:00Z&granularity=1m&aggregation=sum