http_requests_1h_groups

Analytics resource

This is a time-bounded analytics resource. Queries against it differ from typical CRUD resources in a few ways:

• since and until are required. Both are RFC3339 timestamps and define the analytics window (e.g. since = '2026-05-28T00:00:00Z', until = '2026-05-29T00:00:00Z'). Queries without them will fail.
• Row cap via limit. The limit parameter (default 100) bounds the response. Widen the time window or raise limit to return more rows.
• Token scope. Cloudflare's analytics endpoints require an API token with Account -> Analytics -> Read permission, which is broader than typical zone-scoped tokens. A token without it will return empty results.

Creates, updates, deletes, gets or lists a http_requests_1h_groups resource.

Overview

Name	http_requests_1h_groups
Type	Resource
Id	cloudflare.zones.http_requests_1h_groups

Fields

The following fields are returned by SELECT queries:

list

Response

Name	Datatype	Description
bytes	integer	Total bytes served from the edge for the hour.
cached_bytes	integer	Bytes served from cache for the hour.
cached_requests	integer	Requests served from cache for the hour.
date	string (date)	Date component of the hour bucket (YYYY-MM-DD).
datetime	string (date-time)	Hour-bucketed timestamp (RFC3339).
edge_request_bytes	integer	Bytes received from the client over the hour.
encrypted_bytes	integer	Bytes served over TLS for the hour.
encrypted_requests	integer	Requests served over TLS for the hour.
page_views	integer	Successful HTML content requests for the hour.
requests	integer	Total request count for the hour.
threats	integer	Requests classified as threats for the hour.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	zone_tag, since, until	limit	Hourly-bucketed HTTP request totals for a zone. One row per hour with totals for requests, bytes, threats, page views, cache hits/bytes, encrypted requests/bytes, and edge request bytes. Use for last-N-hours traffic dashboards and trend visualisations.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
since	string (date-time)	Lower bound (inclusive) of the time range. RFC3339 (e.g. 2026-05-29T00:00:00Z).
until	string (date-time)	Upper bound (exclusive) of the time range. RFC3339.
zone_tag	string	Cloudflare zone ID (the 32-char hex tag).
limit	integer	Maximum hourly rows to return per call. Default 168 (one week of hourly buckets).

SELECT examples

list

Hourly-bucketed HTTP request totals for a zone. One row per hour with totals for requests, bytes, threats, page views, cache hits/bytes, encrypted requests/bytes, and edge request bytes. Use for last-N-hours traffic dashboards and trend visualisations.

SELECT
bytes,
cached_bytes,
cached_requests,
date,
datetime,
edge_request_bytes,
encrypted_bytes,
encrypted_requests,
page_views,
requests,
threats
FROM cloudflare.zones.http_requests_1h_groups
WHERE zone_tag = '{{ zone_tag }}' -- required
AND since = '{{ since }}' -- required
AND until = '{{ until }}' -- required
AND limit = '{{ limit }}'
;