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

# Get usage bandwidth report.

`GET /v1/sites/{id}/reporting/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

- BandwidthUsageReportingResponseObj — Bandwidth analytics report
  - `result` BandwidthUsageReportingResponseObjResult
    - `totals` object — Usage totals
      - `requests` CountInteger
        - `count` integer
      - `usage` CountInteger
        - `count` integer
      - `visits` CountInteger
        - `count` integer
    - `graph` object — Individual data points
      - `requests` GraphDataPoint[]
        - `count` integer
        - `ts` string — Time stamp of the datapoint
      - `usage` GraphDataPoint[]
        - `count` integer
        - `ts` string — Time stamp of the datapoint
      - `visits` GraphDataPoint[]
        - `count` integer
        - `ts` string — Time stamp of the datapoint
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable

## 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/revisions/db0dcbbc5764/schema)