Get CDN distribution metrics

GET

/cdn/distributions/:distribution_id/metrics

GET

/v1/cdn/distributions/:distribution_id/metrics

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
# DISTRIBUTION_ID: CDN distribution ID
curl "https://api.ibee.ai/v1/cdn/distributions/$DISTRIBUTION_ID/metrics?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

{
  "distribution_id": "<distribution_id>",
  "range": "24h",
  "granularity": "15m",
  "range_start": "2026-10-25T12:00:00Z",
  "range_end": "2026-10-25T12:00:00Z",
  "traffic": {
    "requests": 1,
    "data_served_bytes": 1,
    "response_body_bytes": 1,
    "request_bytes": 1
  },
  "cache": {
    "hit_requests": 1,
    "miss_requests": 1,
    "bypass_requests": 1,
    "dynamic_requests": 1,
    "hit_percentage": 1,
    "data_served_percentage": 1
  },
  "points": [
    {
      "timestamp": "2026-10-25T12:00:00Z"
    }
  ],
  "distribution_name": "<distribution_name>",
  "generated_at": "2026-10-25T12:00:00Z",
  "coverage_complete": true,
  "origin": {
    "fetch_requests": 1,
    "fetch_bytes": 1,
    "average_response_time_ms": 1,
    "request_offload_percentage": 1
  }
}

Returns traffic, cache and origin metrics of the distribution for the last 24 hours, 7 days or 30 days, as the portal’s Metrics tab shows them. Requires scope: cdn.read.

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
# DISTRIBUTION_ID: CDN distribution ID
curl "https://api.ibee.ai/v1/cdn/distributions/$DISTRIBUTION_ID/metrics?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Path parameters

distribution_idstringRequired>=1 character

CDN distribution ID.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

rangeenumOptionalDefaults to 24h

Time range. Default 24h.

Allowed values:

Response

Metrics returned successfully.

distribution_idstring

rangeenum

Allowed values:

granularityenum

Allowed values:

range_startdatetime

range_enddatetime

trafficobject

cacheobject

pointslist of objects

distribution_namestringOptional

generated_atdatetimeOptional

coverage_completebooleanOptional

originobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error