http_requests_adaptive_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_adaptive_groups resource.

Overview

Name	http_requests_adaptive_groups
Type	Resource
Id	cloudflare.zones.http_requests_adaptive_groups

Fields

The following fields are returned by SELECT queries:

list

Response

Name	Datatype	Description
client_country_name	string	ISO-3166 alpha-2 country code derived from client IP.
client_request_http_method_name	string	HTTP method (GET, POST, etc.).
bytes	integer	Total bytes served to the client from the edge.
datetime	string (date-time)	Minute-bucketed timestamp (RFC3339).
edge_response_status	integer	HTTP status returned to the client.
requests	integer	Total request count for this dimension tuple.
visits	integer	Requests by end-users that were initiated from a different website (i.e. the HTTP Referer header does not match the host in the HTTP Host header). A coarse "human visitor" heuristic.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	zone_tag, since, until	limit	HTTP request analytics for a zone with adaptive sampling, grouped by minute, client country, edge response status, and HTTP method. Replaces the sunset REST endpoint /zones/{zone_id}/analytics/dashboard. Each row aggregates request count, byte volume, cache hits, and threat counts for one dimension tuple over the requested time window.

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-28T00: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 number of dimension-tuple rows to return per call.

SELECT examples

list

HTTP request analytics for a zone with adaptive sampling, grouped by minute, client country, edge response status, and HTTP method. Replaces the sunset REST endpoint /zones/{zone_id}/analytics/dashboard. Each row aggregates request count, byte volume, cache hits, and threat counts for one dimension tuple over the requested time window.

SELECT
client_country_name,
client_request_http_method_name,
bytes,
datetime,
edge_response_status,
requests,
visits
FROM cloudflare.zones.http_requests_adaptive_groups
WHERE zone_tag = '{{ zone_tag }}' -- required
AND since = '{{ since }}' -- required
AND until = '{{ until }}' -- required
AND limit = '{{ limit }}'
;