---
title: "Query CDN access logs for a pull zone."
method: GET
path: "/v2/pullzones/{pullZoneId}/logs"
tags: ["Logging v2"]
---

# Query CDN access logs for a pull zone.

`GET /v2/pullzones/{pullZoneId}/logs`

Authenticate with either an `Authorization` bearer JWT or an `AccessKey` header.
Filter pushdown happens in ClickHouse where possible; `country` and free-text
`search` are applied in-process after fetch.

## Path parameters

- `pullZoneId` integer, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `status` string
- `cacheStatus` string
- `country` string
- `edgeLocation` string
- `remoteIp` string
- `urlContains` string
- `userAgentContains` string
- `refererContains` string
- `search` string
- `requestId` string
- `includeOriginShield` boolean
- `limit` integer
- `offset` integer
- `order` string

## Response `200`

Successful query with paginated results.

- LogQueryResponse — Paginated response wrapper for log queries.
  - `data` LogEntry[], nullable, required — Log entries matching the query, in the requested sort order.
    - `logId` string, uuid
    - `timestamp` integer
    - `log` string
    - `labels` object
      - `ErrorCode` string
      - `StatusCode` string
      - `ServerZone` string
  - `pagination` PaginationInfo, required
    - `offset` integer, required — Offset that was applied to this query.
    - `limit` integer, required — Limit that was applied to this query.
    - `returned` integer, required — Number of entries actually returned (≤ bunnynet_cdn_log_api.Models.V2.PaginationInfo.Limit).
    - `hasMore` boolean, required — True if more results are available beyond this page.
  - `query` QuerySummary, required
    - `pullZoneId` integer, required
    - `from` string, date-time, required
    - `to` string, date-time, required
    - `order` string, nullable, required

## Other responses

- `400` — Invalid request parameters.
- `401` — Authentication credentials missing.
- `403` — Authentication failed or pull zone not accessible.
- `404` — Logging is not enabled for the pull zone.
- `429` — Rate limit exceeded for the pull zone.
- `500` — Internal Server Error

---

[API](https://skmtc.net/bunny/apis/bunny-net-cdn-logging.md) · [All operations](https://skmtc.net/bunny/apis/bunny-net-cdn-logging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunny/bunny-net-cdn-logging/versions/9e622620664b/schema)