--- title: Get DNS queries by DNSSEC awareness time series --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Radar](https://developers.cloudflare.com/api/python/resources/radar) [DNS](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns) [Timeseries Groups](https://developers.cloudflare.com/api/python/resources/radar/subresources/dns/subresources/timeseries_groups) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get DNS queries by DNSSEC awareness time series Deprecated: Use \[Radar DNS Timeseries Groups By Dimension](https://developers.cloudflare.com/api/resources/radar/subresources/dns/methods/timeseries\_groups\_v2/) instead. radar.dns.timeseries\_groups.dnssec\_aware(TimeseriesGroupDNSSECAwareParams\*\*kwargs) -> [TimeseriesGroupDNSSECAwareResponse]() GET/radar/dns/timeseries\_groups/dnssec\_aware Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness over time. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `User Details Write``User Details Read` ##### ParametersExpand Collapse

agg\_interval: Optional\[Literal\["15m", "1h", "1d", "1w"]] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. When omitted, the interval is auto-selected from the requested date range; finer intervals are only available for shorter ranges. If the requested interval is too granular for the date range, the request is rejected.

One of the following: "15m" Link to this property "1h" Link to this property "1d" Link to this property "1w" Link to this property

[Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20aggInterval%20%3E%20(schema)>) asn: Optional\[Sequence\[str]] Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with `-` to exclude ASNs from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20asn%20%3E%20(schema)>) continent: Optional\[Sequence\[str]] Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with `-` to exclude continents from results. For example, `-EU,NA` excludes results from EU, but includes results from NA. [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20continent%20%3E%20(schema)>) date\_end: Optional\[Sequence\[Union\[str, datetime]]] End of the date range (inclusive). Alternative to `dateRange`; provide together with `dateStart`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected. [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20dateEnd%20%3E%20(schema)>) date\_range: Optional\[Sequence\[str]] Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `w` for weeks (up to `52w`). Append `control` to request the equivalent previous period for comparison: the comparison window is shifted back by the current window’s length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. `7dcontrol` covers days -14 to -7, `10dcontrol` covers days -24 to -14). For example, pass `7d` and `7dcontrol` to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including `control`) satisfy this automatically. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20dateRange%20%3E%20(schema)>) date\_start: Optional\[Sequence\[Union\[str, datetime]]] Start of the date range. Alternative to `dateRange`; provide together with `dateEnd`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected. [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20dateStart%20%3E%20(schema)>)

format: Optional\[Literal\["JSON", "CSV"]] Format in which results will be returned.

One of the following: "JSON" Link to this property "CSV" Link to this property

[Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20format%20%3E%20(schema)>) location: Optional\[Sequence\[str]] Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with `-` to exclude locations from results. For example, `-US,PT` excludes results from the US, but includes results from PT. [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20location%20%3E%20(schema)>) name: Optional\[Sequence\[str]] Array of names used to label the series in the response. [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) nodata: Optional\[Iterable\[bool]] Specifies whether the response includes empty DNS responses (NODATA). [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20nodata%20%3E%20(schema)>)

protocol: Optional\[List\[Literal\["UDP", "TCP", "HTTPS", "TLS"]]] Filters results by DNS transport protocol.

One of the following: "UDP" Link to this property "TCP" Link to this property "HTTPS" Link to this property "TLS" Link to this property

[Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20protocol%20%3E%20(schema)>)

query\_type: Optional\[List\[Optional\[Literal\["A", "AAAA", "A6", 85 more]]]] Filters results by DNS query type.

[Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20queryType%20%3E%20(schema)>)

response\_code: Optional\[List\[Literal\["NOERROR", "FORMERR", "SERVFAIL", 16 more]]] Filters results by DNS response code.

[Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20responseCode%20%3E%20(schema)>) tld: Optional\[Sequence\[str]] Filters results by top-level domain. Incompatible with the `ipVersion`, `protocol`, `dnssecE2e`, `dnssecAware`, `responseTtl`, and `cacheHit` filters/dimensions; this restriction does not apply to country-code TLDs (2-letter, e.g. `uk`). [Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(method)%20dnssec_aware%20%3E%20(params)%20default%20%3E%20(param)%20tld%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class TimeseriesGroupDNSSECAwareResponse: …

meta: Meta Metadata for the results.

agg\_interval: Literal\["FIFTEEN\_MINUTES", "ONE\_HOUR", "ONE\_DAY", 2 more] Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: "FIFTEEN\_MINUTES" Link to this property "ONE\_HOUR" Link to this property "ONE\_DAY" Link to this property "ONE\_WEEK" Link to this property "ONE\_MONTH" Link to this property

Link to this property

confidence\_info: MetaConfidenceInfo

annotations: List\[MetaConfidenceInfoAnnotation]

data\_source: Literal\["ALL", "AI\_BOTS", "AI\_GATEWAY", 22 more] Data source for annotations.

Link to this property description: str Link to this property end\_date: datetime formatdate-time Link to this property

event\_type: Literal\["GENERAL", "OUTAGE", "PARTIAL\_PROJECTION", 2 more] Event type for annotations.

One of the following: "GENERAL" Link to this property "OUTAGE" Link to this property "PARTIAL\_PROJECTION" Link to this property "PIPELINE" Link to this property "TRAFFIC\_ANOMALY" Link to this property

Link to this property is\_instantaneous: bool Whether event is a single point in time or a time range. Link to this property linked\_url: str formaturi Link to this property start\_date: datetime formatdate-time Link to this property tags: Optional\[List\[str]] Link to this property

Link to this property level: int Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

date\_range: List\[MetaDateRange]

end\_time: datetime Adjusted end of date range. formatdate-time Link to this property start\_time: datetime Adjusted start of date range. formatdate-time Link to this property

Link to this property last\_updated: datetime Timestamp of the last dataset update. formatdate-time Link to this property

normalization: Literal\["PERCENTAGE", "MIN0\_MAX", "MIN\_MAX", 5 more] Normalization method applied to the results. Refer to Normalization methods.

One of the following: "PERCENTAGE" Link to this property "MIN0\_MAX" Link to this property "MIN\_MAX" Link to this property "RAW\_VALUES" Link to this property "PERCENTAGE\_CHANGE" Link to this property "ROLLING\_AVERAGE" Link to this property "OVERLAPPED\_PERCENTAGE" Link to this property "RATIO" Link to this property

Link to this property

units: List\[MetaUnit] Measurement units for the results.

name: str Link to this property value: str Link to this property

Link to this property

serie\_0: Serie0

not\_supported: List\[str] Link to this property supported: List\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.dns.timeseries_groups%20%3E%20(model)%20timeseries_group_dnssec_aware_response%20%3E%20(schema)>) ### Get DNS queries by DNSSEC awareness time series Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.radar.dns.timeseries_groups.dnssec_aware() print(response.meta) ``` 200 example ``` { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] }, "serie_0": { "NOT_SUPPORTED": [ "10" ], "SUPPORTED": [ "10" ] } }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] }, "serie_0": { "NOT_SUPPORTED": [ "10" ], "SUPPORTED": [ "10" ] } }, "success": true } ```