---
title: "Get usage bandwidth report."
method: GET
path: "/v1/reporting/sites/{id}/bandwidth/usage"
tags: ["Reporting"]
---

# Get usage bandwidth report.

`GET /v1/reporting/sites/{id}/bandwidth/usage`

For given site it checks cloudflare stats for usage histogram.

## Path parameters

- `id` integer, required — ID of the Site you are interacting with

## Query parameters

- `duration` '30m' | '1h' | '6h' | '12h' | '24h' | '72h' | '7d' | '30d', required — Duration that the listed data is for (m = minutes, h = hours, d = days)

## Response `200`

OK

- BandwidthUsageReportingResponse
  - `data` BandwidthUsageViewer
    - `viewer` object
      - `__typename` 'viewer' — name of the property
      - `zones` BandwidthUsageZone[]
        - `__typename` 'zone' — name of the property
        - `series` BandwidthUsageZoneInfo[] — Request summary for each type of request
          - `__typename` 'ZoneHttpRequestsAdaptiveGroups' — name of the property
          - `avg` ZoneHttpRequestsAdaptiveGroupsAvg
            - `__typename` 'ZoneHttpRequestsAdaptiveGroupsAvg' — name of the property
            - `sampleInterval` number
          - `count` integer — Overall number of requests with this cache status
          - `dimensions` object
            - `__typename` 'ZoneHttpRequestsAdaptiveGroupsDimensions' — name of the property
            - `ts` string — Time stamp of the datapoint
          - `sum` ZoneHttpRequestsAdaptiveGroupsSumEdgeResponseBytes
            - `__typename` 'ZoneHttpRequestsAdaptiveGroupsSum' — name of the property
            - `edgeResponseBytes` integer — number of bytes transferred for this type of request
  - `success` boolean — whether the request succeeded
  - `errors` string[]

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Not authorized to access endpoint
- `404` — Given site not found for user
- `405` — Invalid input
- `500` — Internal error

---

[API](https://skmtc.net/rocket/apis/rocket-net-api.md) · [All operations](https://skmtc.net/rocket/apis/rocket-net-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rocket/rocket-net-api/versions/db0dcbbc5764/schema)