v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Zones

Get Zone Statistics

Statistics of DNS zone in common and by record types.

To get summary statistics for all zones use all instead of zone name in path.

Note: Consumption statistics is updated in near real-time as a standard practice. However, the frequency of updates can vary, but they are typically available within a 30 minutes period. Exceptions, such as maintenance periods, may delay data beyond 30 minutes until servers resume and backfill missing statistics.

get/dns/v2/zones/{name}/statistics

Path parameters

namestring required

Zone name.

Use all to get statistics for all zones.

Query parameters

frominteger

Beginning of the requested time period (Unix Timestamp, UTC.)

In a query string: &from=1709068637

tointeger

End of the requested time period (Unix Timestamp, UTC.)

In a query string: &to=1709673437

record_typestring

DNS record type.

Possible values:

  • A
  • AAAA
  • NS
  • CNAME
  • MX
  • TXT
  • SVCB
  • HTTPS
granularitystring

Granularity parameter string is a sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "1.5h" or "2h45m".

Valid time units are "s", "m", "h".

Response

StatisticsZoneResponse

requestsobject

Requests amount (values) for particular zone fractionated by time intervals (keys).

Example of response: { "requests": { "1598608080000": 14716, "1598608140000": 51167, "1598608200000": 53432, "1598611020000": 51050, "1598611080000": 52611, "1598611140000": 46884 } }

totalinteger

Total - sum of all values