---
title: "Analytics about DNS queries"
method: GET
path: "/{account}/dns_analytics"
tags: ["billing", "zones"]
---

# Analytics about DNS queries

`GET /{account}/dns_analytics`

Queries and returns DNS Analytics data available for the provided query parameters. This API is currently in Public Beta. During the Public Beta period, changes may occur at any time.

## Path parameters

- `account` integer, required

## Query parameters

- `start_date` string, date — A date value formatted as ISO 8601.
- `end_date` string, date — A date value formatted as ISO 8601.
- `groupings` 'date' | 'volume' | 'zone_name'
- `sort` string
- `page` integer
- `per_page` integer

## Response `200`

Successfully retrieved DNS analytics data.

- object
  - `data` object, required
    - `rows` union[], required
      - union
        - integer
        - string
        - string, date — A date value formatted as ISO 8601.
    - `headers` string[], required
  - `query` object, required
    - `account_id` integer, required
    - `start_date` string, date, nullable, required — A nullable date-time value. The value can be null, when present the value is formatted according to the ISO 8601 specification.
    - `end_date` string, date, nullable, required — A nullable date-time value. The value can be null, when present the value is formatted according to the ISO 8601 specification.
    - `sort` string, required — Sorting applied to the returned data.
    - `groupings` string, nullable, required — Grouping applied to the returned data.
    - `page` integer, required — The returned page number.
    - `per_page` integer, required — The page size used to generate the data.
  - `pagination` Pagination, required
    - `current_page` integer, required
    - `per_page` integer, required
    - `total_entries` integer, required
    - `total_pages` integer, required

## Changes

- **2025-07-11** (v2) `06780be0ef17` — 3 breaking, 16 info
  - the response property `query/end_date` became nullable for the status `200`
  - the response property `query/groupings` became nullable for the status `200`
  - the response property `query/start_date` became nullable for the status `200`
  - the response property `data` became required for the status `200`
  - …15 more
- **2024-04-10** (v2) `9dd10ef47b12` — 1 info
  - api operation id `dnsAnalytics` removed and replaced with `queryDnsAnalytics`
- **2024-02-09** (v2) `e9a84a743ab9` — 1 info
  - endpoint added
- **2023-07-18** (v2) `c8591dcf8c29` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/dns_analytics/get.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)