Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bunny.net/llms.txt

Use this file to discover all available pages before exploring further.

The Logging API provides access to raw request logs for all pull zones with logging enabled. Logs appear in near real-time and are retained for 3 days.

​
Base URL

https://logging.bunnycdn.com

​
Authentication

Authenticate using the AccessKey header or a bearer JWT: 
curl --request GET \
  --url https://logging.bunnycdn.com/v2/pullzones/{pullZoneId}/logs \
  --header 'AccessKey: YOUR_API_KEY'

curl --request GET \
  --url https://logging.bunnycdn.com/v2/pullzones/{pullZoneId}/logs \
  --header 'Authorization: Bearer YOUR_JWT'
Find your API key in the account settings under API Keys.

​
API versions

Two versions of the API are available:
VersionFormatDescription
v2JSONStructured JSON with rich filtering, pagination, and per-field search. Recommended.
v1Pipe-delimitedStreams a raw pipe-delimited file for a given day. Preserved for existing integrations.

​
Cache status values

Both API versions return the following cache status values:
ValueDescription
HITResponse served directly from cache
MISSResponse not in cache; fetched from origin
BYPASSCache was skipped (e.g. due to request headers, cookies, or configuration)
REVALIDATEDCached response was validated with origin and reused
STALEStale cached response served (typically due to origin being unavailable or slow)
UPDATINGStale content served while a background cache update is in progress
-No cache interaction (e.g. non-cacheable methods like POST)

​
Rate limits

Both API versions enforce a per-pull-zone rate limit of 30 requests per 10 seconds. Exceeding this returns a 429 response.

​
Error codes

HTTP StatusCodeDescription
400invalid_requestOne or more query parameters failed validation
401unauthorizedNo authentication credentials provided
403forbiddenCredentials are invalid, or pull zone is suspended/disabled
404logging_disabledLogging is not enabled for this pull zone
429rate_limitedPer-pull-zone rate limit exceeded
500internal_errorUnexpected server error