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 /v2/zones/{name}/statistics

Get Zone Statistics

cURL

curl --request GET \
  --url https://api.___serverhost___/dns/v2/zones/{name}/statistics

200

{
  "requests": {},
  "total": 123
}

Path Parameters

name · string · required

Zone name.

Use all to get statistics for all zones.

Query Parameters

from · integer<int64>

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

In a query string: &from=1709068637

to · integer<int64>

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

In a query string: &to=1709673437

record_type · string

DNS record type.

Possible values:

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

granularity · string

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

200

application/json

StatisticsZoneResponse

StatisticsZoneResponse

requests · object

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 } }

total · integer<uint64>

Total - sum of all values