Skip to main content
GET
/
statistics
Get Statistics
curl --request GET \
  --url https://api.bunny.net/statistics \
  --header 'AccessKey: <api-key>'
{
  "TotalBandwidthUsed": 123,
  "TotalOriginTraffic": 123,
  "AverageOriginResponseTime": 123,
  "OriginResponseTimeChart": {},
  "TotalRequestsServed": 123,
  "CacheHitRate": 123,
  "BandwidthUsedChart": {},
  "BandwidthCachedChart": {},
  "CacheHitRateChart": {},
  "RequestsServedChart": {},
  "PullRequestsPulledChart": {},
  "OriginShieldBandwidthUsedChart": {},
  "OriginShieldInternalBandwidthUsedChart": {},
  "OriginTrafficChart": {},
  "UserBalanceHistoryChart": {},
  "GeoTrafficDistribution": {},
  "Error3xxChart": {},
  "Error4xxChart": {},
  "Error5xxChart": {}
}

Authorizations

​
AccessKey
string
header
required

API Access Key authorization header

Query Parameters

​
dateFrom
string<date-time> | null

(Optional) The start date of the statistics. If no value is passed, the last 30 days will be returned.

​
dateTo
string<date-time> | null

(Optional) The end date of the statistics. If no value is passed, the last 30 days will be returned.

​
pullZone
integer<int64>
default:-1

(Optional) If set, the statistics will be only returned for the given Pull Zone

​
serverZoneId
integer<int64>
default:-1

(Optional) If set, the statistics will be only returned for the given region ID

​
loadErrors
boolean
default:false

(Optional) If set, the respose will contain the non-2xx response

​
hourly
boolean
default:false

(Optional) If true, the statistics data will be returned in hourly groupping.

​
exactRange
boolean
default:false

(Optional) If true and hourly=true, the exact hour components of dateFrom and dateTo will be preserved instead of rounding to full-day boundaries.

​
loadOriginResponseTimes
boolean
default:false

Load Origin Response Times

​
loadOriginTraffic
boolean
default:false

Load Origin Traffic

​
loadRequestsServed
boolean
default:false

Load Requests Served

​
loadBandwidthUsed
boolean
default:false

Load Bandwidth Used

​
loadOriginShieldBandwidth
boolean
default:false

Load Origin Shield Bandwidth

​
loadGeographicTrafficDistribution
boolean
default:false

Load Geographic Traffic Distribution

​
loadUserBalanceHistory
boolean
default:false

Load User Balance History

Response

The statistics data for the passed parameters.

​
TotalBandwidthUsed
integer<int64>

The total bandwidth used by the response in the given time range

​
TotalOriginTraffic
integer<int64>

The total amount of traffic received from the origin

​
AverageOriginResponseTime
integer<int32>

The median response time origin

​
OriginResponseTimeChart
object

The constructed origin response time chart data

​
TotalRequestsServed
integer<int64>

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

The constructed bandwdidth used chart data

​
BandwidthCachedChart
object

The constructed cached bandwdidth used chart data

​
CacheHitRateChart
object

The constructed cache hit rate chart data

​
RequestsServedChart
object

The constructed requests served chart data

​
PullRequestsPulledChart
object

The constructed uncached requests served chart data

​
OriginShieldBandwidthUsedChart
object

The constructed origin shield bandwdidth used chart data

​
OriginShieldInternalBandwidthUsedChart
object

The constructed origin shield internal bandwdidth used chart data

​
OriginTrafficChart
object

The constructed origin traffic used chart data

​
UserBalanceHistoryChart
object

The constructed user balance history chart data

​
GeoTrafficDistribution
object

The geo traffic distribution data

​
Error3xxChart
object

The constructed 3XX error responses chart data

​
Error4xxChart
object

The constructed 4XX error responses chart data

​
Error5xxChart
object

The constructed 5XX error responses chart data