---
title: "Get Statistics"
method: GET
path: "/statistics"
tags: ["Statistics"]
---

# Get Statistics

`GET /statistics`

## Request

- Base URL: `https://api.bunny.net`
- URL: `https://api.bunny.net/statistics`
- Auth: one of:
  - API key in header `AccessKey`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bunny/apis/bunny-net-api/docs/statistics/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `dateFrom` string, date-time, nullable
- `dateTo` string, date-time, nullable
- `pullZone` integer
- `serverZoneId` integer
- `loadErrors` boolean
- `hourly` boolean
- `exactRange` boolean
- `loadOriginResponseTimes` boolean
- `loadOriginTraffic` boolean
- `loadRequestsServed` boolean
- `loadBandwidthUsed` boolean
- `loadOriginShieldBandwidth` boolean
- `loadGeographicTrafficDistribution` boolean
- `loadUserBalanceHistory` boolean

## Response `200`

The statistics data for the passed parameters.

- StatisticsModel
  - `TotalBandwidthUsed` integer: The total bandwidth used by the response in the given time range
  - `TotalOriginTraffic` integer: The total amount of traffic received from the origin
  - `AverageOriginResponseTime` integer: The median response time origin
  - `OriginResponseTimeChart` object, nullable: The constructed origin response time chart data
  - `TotalRequestsServed` integer: The total requests served by the response in the given time range
  - `CacheHitRate` number, double: The average cache hit rate in the response in the given time range
  - `BandwidthUsedChart` object, nullable: The constructed bandwdidth used chart data
  - `BandwidthCachedChart` object, nullable: The constructed cached bandwdidth used chart data
  - `CacheHitRateChart` object, nullable: The constructed cache hit rate chart data
  - `RequestsServedChart` object, nullable: The constructed requests served chart data
  - `PullRequestsPulledChart` object, nullable: The constructed uncached requests served chart data
  - `OriginShieldBandwidthUsedChart` object, nullable: The constructed origin shield bandwdidth used chart data
  - `OriginShieldInternalBandwidthUsedChart` object, nullable: The constructed origin shield internal bandwdidth used chart data
  - `OriginTrafficChart` object, nullable: The constructed origin traffic used chart data
  - `UserBalanceHistoryChart` object, nullable: The constructed user balance history chart data
  - `GeoTrafficDistribution` object, nullable: The geo traffic distribution data
  - `Error3xxChart` object, nullable: The constructed 3XX error responses chart data
  - `Error4xxChart` object, nullable: The constructed 4XX error responses chart data
  - `Error5xxChart` object, nullable: The constructed 5XX error responses chart data

## Other responses

- `401`: The request authorization failed
- `500`: Internal Server Error

## Changes

- **2026-10-27** `2096a6606d8d`: 2 info
  - the security scope `ScopedApiKey` was added to the endpoint's security scheme `AccessKey`
  - the security scope `ScopedApiKey` was added to the endpoint's security scheme `bearer`
- **2026-04-12** `9123bf5c2354`: 1 info
  - added the new optional `query` request parameter `exactRange`

[Operation history](https://skmtc.dev/bunny/apis/bunny-net-api/changes/statistics/get.md)

---

[API](https://skmtc.dev/bunny/apis/bunny-net-api.md) - [All operations](https://skmtc.dev/bunny/apis/bunny-net-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/bunny-net-api/revisions/2b06f94dbfbf?raw)