---
title: "Get traffic data"
method: GET
path: "/waap/v1/analytics/traffic"
tags: ["Analytics"]
---

# Get traffic data

`GET /waap/v1/analytics/traffic`

Retrieves a comprehensive report on traffic statistics for a set of domains. The report includes details such as API requests, blocked events, error counts, and many more traffic-related metrics.

## Query parameters

- `domains` integer[] — List of domain IDs. Empty list means all domains belonging to the current account.
- `resolution` 'daily' | 'hourly' | 'minutely', required — Specifies the granularity of the result data.
- `bucket_size` 60 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 10800 | 21600 | 43200 | 86400, nullable — Optional explicit aggregation bucket width in seconds. When supplied, `bucket_size` supersedes `resolution` for aggregation granularity.
- `start` string, required — Filter data items starting from a specified date in ISO 8601 format
- `end` string, nullable — Filter data items up to a specified end date in ISO 8601 format. If not provided, defaults to the current date and time.

## Response `200`

Successful Response

- TrafficMetrics[]
  - `timestamp` integer, required — UNIX timestamp indicating when the traffic data was recorded
  - `ajax` integer — Number of AJAX requests made
  - `api` integer — Number of API requests made
  - `ddosBlocked` integer — Number of DDoS attack attempts successfully blocked
  - `origin2xx` integer — Number of successful HTTP 2xx responses from the origin server
  - `origin3xx` integer — Number of HTTP 3xx redirects issued by the origin server
  - `originError4xx` integer — Number of HTTP 4xx errors from the origin server
  - `originError5xx` integer — Number of HTTP 5xx errors from the origin server
  - `monitored` integer — Number of requests triggering monitoring actions
  - `uncategorized` integer — Requests resulting in neither blocks nor sanctions
  - `static` integer — Number of static asset requests
  - `responseTime` integer — Average origin server response time in milliseconds
  - `originTimeout` integer — Number of timeouts experienced at the origin server
  - `customAllowed` integer — Number of requests allowed through custom rules
  - `total` integer — Total number of requests
  - `passedToOrigin` integer — Number of requests served directly by the origin server
  - `customBlocked` integer — Number of requests blocked due to custom rules
  - `policyAllowed` integer — Number of requests allowed by security policies
  - `policyBlocked` integer — Number of requests blocked by security policies

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Unauthenticated
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-05-04** `24421e25cf7e` — 1 info
  - added the new optional `query` request parameter `bucket_size`

[Change history](https://skmtc.dev/g-core/apis/gcore-openapi/changes/waap/v1/analytics/traffic/get.md)

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)