# DNS

## Get DNS summary by dimension

`client.radar.dns.summaryV2("AS" | "CACHE_HIT" | "DNSSEC" | 11 moredimension, DNSSummaryV2Paramsquery?, RequestOptionsoptions?): DNSSummaryV2Response`

**get** `/radar/dns/summary/{dimension}`

Retrieves the distribution of DNS queries by the specified dimension.

### Parameters

- `dimension: "AS" | "CACHE_HIT" | "DNSSEC" | 11 more`

  Specifies the attribute by which to group the results.

  - `"AS"`

  - `"CACHE_HIT"`

  - `"DNSSEC"`

  - `"DNSSEC_AWARE"`

  - `"DNSSEC_E2E"`

  - `"IP_VERSION"`

  - `"LOCATION"`

  - `"MATCHING_ANSWER"`

  - `"PROTOCOL"`

  - `"QUERY_TYPE"`

  - `"RESPONSE_CODE"`

  - `"RESPONSE_TTL"`

  - `"TLD"`

  - `"TLD_DNS_MAGNITUDE"`

- `query: DNSSummaryV2Params`

  - `asn?: Array<string>`

    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.

  - `cacheHit?: Array<boolean>`

    Filters results based on cache status.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `dnssec?: Array<"INVALID" | "INSECURE" | "SECURE" | "OTHER">`

    Filters results based on DNSSEC (DNS Security Extensions) support.

    - `"INVALID"`

    - `"INSECURE"`

    - `"SECURE"`

    - `"OTHER"`

  - `dnssecAware?: Array<"SUPPORTED" | "NOT_SUPPORTED">`

    Filters results based on DNSSEC (DNS Security Extensions) client awareness.

    - `"SUPPORTED"`

    - `"NOT_SUPPORTED"`

  - `dnssecE2e?: Array<boolean>`

    Filters results based on DNSSEC-validated answers by end-to-end security status.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `ipVersion?: Array<"IPv4" | "IPv6">`

    Filters results by IP version (Ipv4 vs. IPv6).

    - `"IPv4"`

    - `"IPv6"`

  - `limitPerGroup?: number`

    Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

  - `location?: Array<string>`

    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.

  - `matchingAnswer?: Array<boolean>`

    Filters results based on whether the queries have a matching answer.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `responseTtl?: Array<"LTE_1M" | "GT_1M_LTE_5M" | "GT_5M_LTE_15M" | 4 more>`

    Filters results by DNS response TTL.

    - `"LTE_1M"`

    - `"GT_1M_LTE_5M"`

    - `"GT_5M_LTE_15M"`

    - `"GT_15M_LTE_1H"`

    - `"GT_1H_LTE_1D"`

    - `"GT_1D_LTE_1W"`

    - `"GT_1W"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `DNSSummaryV2Response`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Record<string, string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summaryV2('AS');

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "IPv4": "50.168733",
      "IPv6": "25.084366"
    }
  },
  "success": true
}
```

## Get DNS queries time series

`client.radar.dns.timeseries(DNSTimeseriesParamsquery?, RequestOptionsoptions?): DNSTimeseriesResponse`

**get** `/radar/dns/timeseries`

Retrieves normalized query volume to the 1.1.1.1 DNS resolver over time.

### Parameters

- `query: DNSTimeseriesParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `cacheHit?: Array<boolean>`

    Filters results based on cache status.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `dnssec?: Array<"INVALID" | "INSECURE" | "SECURE" | "OTHER">`

    Filters results based on DNSSEC (DNS Security Extensions) support.

    - `"INVALID"`

    - `"INSECURE"`

    - `"SECURE"`

    - `"OTHER"`

  - `dnssecAware?: Array<"SUPPORTED" | "NOT_SUPPORTED">`

    Filters results based on DNSSEC (DNS Security Extensions) client awareness.

    - `"SUPPORTED"`

    - `"NOT_SUPPORTED"`

  - `dnssecE2e?: Array<boolean>`

    Filters results based on DNSSEC-validated answers by end-to-end security status.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `ipVersion?: Array<"IPv4" | "IPv6">`

    Filters results by IP version (Ipv4 vs. IPv6).

    - `"IPv4"`

    - `"IPv6"`

  - `location?: Array<string>`

    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.

  - `matchingAnswer?: Array<boolean>`

    Filters results based on whether the queries have a matching answer.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `responseTtl?: Array<"LTE_1M" | "GT_1M_LTE_5M" | "GT_5M_LTE_15M" | 4 more>`

    Filters results by DNS response TTL.

    - `"LTE_1M"`

    - `"GT_1M_LTE_5M"`

    - `"GT_5M_LTE_15M"`

    - `"GT_15M_LTE_1H"`

    - `"GT_1H_LTE_1D"`

    - `"GT_1D_LTE_1W"`

    - `"GT_1W"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `DNSTimeseriesResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseries();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    }
  },
  "success": true
}
```

## Get DNS time series grouped by dimension

`client.radar.dns.timeseriesGroupsV2("AS" | "CACHE_HIT" | "DNSSEC" | 10 moredimension, DNSTimeseriesGroupsV2Paramsquery?, RequestOptionsoptions?): DNSTimeseriesGroupsV2Response`

**get** `/radar/dns/timeseries_groups/{dimension}`

Retrieves the distribution of DNS queries grouped by dimension over time.

### Parameters

- `dimension: "AS" | "CACHE_HIT" | "DNSSEC" | 10 more`

  Specifies the attribute by which to group the results.

  - `"AS"`

  - `"CACHE_HIT"`

  - `"DNSSEC"`

  - `"DNSSEC_AWARE"`

  - `"DNSSEC_E2E"`

  - `"IP_VERSION"`

  - `"LOCATION"`

  - `"MATCHING_ANSWER"`

  - `"PROTOCOL"`

  - `"QUERY_TYPE"`

  - `"RESPONSE_CODE"`

  - `"RESPONSE_TTL"`

  - `"TLD"`

- `query: DNSTimeseriesGroupsV2Params`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `cacheHit?: Array<boolean>`

    Filters results based on cache status.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `dnssec?: Array<"INVALID" | "INSECURE" | "SECURE" | "OTHER">`

    Filters results based on DNSSEC (DNS Security Extensions) support.

    - `"INVALID"`

    - `"INSECURE"`

    - `"SECURE"`

    - `"OTHER"`

  - `dnssecAware?: Array<"SUPPORTED" | "NOT_SUPPORTED">`

    Filters results based on DNSSEC (DNS Security Extensions) client awareness.

    - `"SUPPORTED"`

    - `"NOT_SUPPORTED"`

  - `dnssecE2e?: Array<boolean>`

    Filters results based on DNSSEC-validated answers by end-to-end security status.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `ipVersion?: Array<"IPv4" | "IPv6">`

    Filters results by IP version (Ipv4 vs. IPv6).

    - `"IPv4"`

    - `"IPv6"`

  - `limitPerGroup?: number`

    Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

  - `location?: Array<string>`

    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.

  - `matchingAnswer?: Array<boolean>`

    Filters results based on whether the queries have a matching answer.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `normalization?: "PERCENTAGE" | "MIN0_MAX"`

    Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

    - `"PERCENTAGE"`

    - `"MIN0_MAX"`

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `responseTtl?: Array<"LTE_1M" | "GT_1M_LTE_5M" | "GT_5M_LTE_15M" | 4 more>`

    Filters results by DNS response TTL.

    - `"LTE_1M"`

    - `"GT_1M_LTE_5M"`

    - `"GT_5M_LTE_15M"`

    - `"GT_15M_LTE_1H"`

    - `"GT_1H_LTE_1D"`

    - `"GT_1D_LTE_1W"`

    - `"GT_1W"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `DNSTimeseriesGroupsV2Response`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `timestamps: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroupsV2('AS');

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "success": true
}
```

## Domain Types

### DNS Summary V2 Response

- `DNSSummaryV2Response`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Record<string, string>`

### DNS Timeseries Response

- `DNSTimeseriesResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

### DNS Timeseries Groups V2 Response

- `DNSTimeseriesGroupsV2Response`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `timestamps: Array<string>`

# Top

## Get top ASes by DNS queries

`client.radar.dns.top.ases(TopAsesParamsquery?, RequestOptionsoptions?): TopAsesResponse`

**get** `/radar/dns/top/ases`

Retrieves the top autonomous systems by DNS queries made to 1.1.1.1 DNS resolver.

### Parameters

- `query: TopAsesParams`

  - `asn?: Array<string>`

    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.

  - `cacheHit?: Array<boolean>`

    Filters results based on cache status.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `dnssec?: Array<"INVALID" | "INSECURE" | "SECURE" | "OTHER">`

    Filters results based on DNSSEC (DNS Security Extensions) support.

    - `"INVALID"`

    - `"INSECURE"`

    - `"SECURE"`

    - `"OTHER"`

  - `dnssecAware?: Array<"SUPPORTED" | "NOT_SUPPORTED">`

    Filters results based on DNSSEC (DNS Security Extensions) client awareness.

    - `"SUPPORTED"`

    - `"NOT_SUPPORTED"`

  - `dnssecE2e?: Array<boolean>`

    Filters results based on DNSSEC-validated answers by end-to-end security status.

  - `domain?: Array<string>`

    Filters results by domain name.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `ipVersion?: Array<"IPv4" | "IPv6">`

    Filters results by IP version (Ipv4 vs. IPv6).

    - `"IPv4"`

    - `"IPv6"`

  - `limit?: number`

    Limits the number of objects returned in the response.

  - `location?: Array<string>`

    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.

  - `matchingAnswer?: Array<boolean>`

    Filters results based on whether the queries have a matching answer.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `responseTtl?: Array<"LTE_1M" | "GT_1M_LTE_5M" | "GT_5M_LTE_15M" | 4 more>`

    Filters results by DNS response TTL.

    - `"LTE_1M"`

    - `"GT_1M_LTE_5M"`

    - `"GT_5M_LTE_15M"`

    - `"GT_15M_LTE_1H"`

    - `"GT_1H_LTE_1D"`

    - `"GT_1D_LTE_1W"`

    - `"GT_1W"`

### Returns

- `TopAsesResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo | null`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `top_0: Array<Top0>`

    - `clientASN: number`

    - `clientASName: string`

    - `value: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.top.ases();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "top_0": [
      {
        "clientASN": 3243,
        "clientASName": "MEO",
        "value": "10"
      }
    ]
  },
  "success": true
}
```

## Get top locations by DNS queries

`client.radar.dns.top.locations(TopLocationsParamsquery?, RequestOptionsoptions?): TopLocationsResponse`

**get** `/radar/dns/top/locations`

Retrieves the top locations by DNS queries made to 1.1.1.1 DNS resolver.

### Parameters

- `query: TopLocationsParams`

  - `asn?: Array<string>`

    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.

  - `cacheHit?: Array<boolean>`

    Filters results based on cache status.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `dnssec?: Array<"INVALID" | "INSECURE" | "SECURE" | "OTHER">`

    Filters results based on DNSSEC (DNS Security Extensions) support.

    - `"INVALID"`

    - `"INSECURE"`

    - `"SECURE"`

    - `"OTHER"`

  - `dnssecAware?: Array<"SUPPORTED" | "NOT_SUPPORTED">`

    Filters results based on DNSSEC (DNS Security Extensions) client awareness.

    - `"SUPPORTED"`

    - `"NOT_SUPPORTED"`

  - `dnssecE2e?: Array<boolean>`

    Filters results based on DNSSEC-validated answers by end-to-end security status.

  - `domain?: Array<string>`

    Filters results by domain name.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `ipVersion?: Array<"IPv4" | "IPv6">`

    Filters results by IP version (Ipv4 vs. IPv6).

    - `"IPv4"`

    - `"IPv6"`

  - `limit?: number`

    Limits the number of objects returned in the response.

  - `location?: Array<string>`

    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.

  - `matchingAnswer?: Array<boolean>`

    Filters results based on whether the queries have a matching answer.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `responseTtl?: Array<"LTE_1M" | "GT_1M_LTE_5M" | "GT_5M_LTE_15M" | 4 more>`

    Filters results by DNS response TTL.

    - `"LTE_1M"`

    - `"GT_1M_LTE_5M"`

    - `"GT_5M_LTE_15M"`

    - `"GT_15M_LTE_1H"`

    - `"GT_1H_LTE_1D"`

    - `"GT_1D_LTE_1W"`

    - `"GT_1W"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TopLocationsResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo | null`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `top_0: Array<Top0>`

    - `clientCountryAlpha2: string`

    - `clientCountryName: string`

    - `value: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.top.locations();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "top_0": [
      {
        "clientCountryAlpha2": "PT",
        "clientCountryName": "Portugal",
        "value": "10"
      }
    ]
  },
  "success": true
}
```

## Domain Types

### Top Ases Response

- `TopAsesResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo | null`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `top_0: Array<Top0>`

    - `clientASN: number`

    - `clientASName: string`

    - `value: string`

      A numeric string.

### Top Locations Response

- `TopLocationsResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo | null`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `top_0: Array<Top0>`

    - `clientCountryAlpha2: string`

    - `clientCountryName: string`

    - `value: string`

      A numeric string.

# Summary

## Get DNS queries by cache status summary

`client.radar.dns.summary.cacheHit(SummaryCacheHitParamsquery?, RequestOptionsoptions?): SummaryCacheHitResponse`

**get** `/radar/dns/summary/cache_hit`

Retrieves the distribution of DNS queries by cache status.

### Parameters

- `query: SummaryCacheHitParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryCacheHitResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NEGATIVE: string`

      A numeric string.

    - `POSITIVE: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.cacheHit();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "NEGATIVE": "10",
      "POSITIVE": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by DNSSEC support summary

`client.radar.dns.summary.dnssec(SummaryDNSSECParamsquery?, RequestOptionsoptions?): SummaryDNSSECResponse`

**get** `/radar/dns/summary/dnssec`

Retrieves the distribution of DNS responses by DNSSEC (DNS Security Extensions) support.

### Parameters

- `query: SummaryDNSSECParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryDNSSECResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `INSECURE: string`

      A numeric string.

    - `INVALID: string`

      A numeric string.

    - `OTHER: string`

      A numeric string.

    - `SECURE: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.dnssec();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "INSECURE": "10",
      "INVALID": "10",
      "OTHER": "10",
      "SECURE": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by DNSSEC awareness summary

`client.radar.dns.summary.dnssecAware(SummaryDNSSECAwareParamsquery?, RequestOptionsoptions?): SummaryDNSSECAwareResponse`

**get** `/radar/dns/summary/dnssec_aware`

Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness.

### Parameters

- `query: SummaryDNSSECAwareParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryDNSSECAwareResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NOT_SUPPORTED: string`

      A numeric string.

    - `SUPPORTED: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.dnssecAware();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "NOT_SUPPORTED": "10",
      "SUPPORTED": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by DNSSEC end-to-end summary

`client.radar.dns.summary.dnssecE2E(SummaryDNSSECE2EParamsquery?, RequestOptionsoptions?): SummaryDNSSECE2EResponse`

**get** `/radar/dns/summary/dnssec_e2e`

Retrieves the distribution of DNSSEC-validated answers by end-to-end security status.

### Parameters

- `query: SummaryDNSSECE2EParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryDNSSECE2EResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NEGATIVE: string`

      A numeric string.

    - `POSITIVE: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.dnssecE2E();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "NEGATIVE": "10",
      "POSITIVE": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by IP version summary

`client.radar.dns.summary.ipVersion(SummaryIPVersionParamsquery?, RequestOptionsoptions?): SummaryIPVersionResponse`

**get** `/radar/dns/summary/ip_version`

Retrieves the distribution of DNS queries by IP version.

### Parameters

- `query: SummaryIPVersionParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryIPVersionResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `IPv4: string`

      A numeric string.

    - `IPv6: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.ipVersion();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "IPv4": "10",
      "IPv6": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by matching answer summary

`client.radar.dns.summary.matchingAnswer(SummaryMatchingAnswerParamsquery?, RequestOptionsoptions?): SummaryMatchingAnswerResponse`

**get** `/radar/dns/summary/matching_answer`

Retrieves the distribution of DNS queries by matching answers.

### Parameters

- `query: SummaryMatchingAnswerParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryMatchingAnswerResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NEGATIVE: string`

      A numeric string.

    - `POSITIVE: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.matchingAnswer();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "NEGATIVE": "10",
      "POSITIVE": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by protocol summary

`client.radar.dns.summary.protocol(SummaryProtocolParamsquery?, RequestOptionsoptions?): SummaryProtocolResponse`

**get** `/radar/dns/summary/protocol`

Retrieves the distribution of DNS queries by DNS transport protocol.

### Parameters

- `query: SummaryProtocolParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryProtocolResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `HTTPS: string`

      A numeric string.

    - `TCP: string`

      A numeric string.

    - `TLS: string`

      A numeric string.

    - `UDP: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.protocol();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "HTTPS": "10",
      "TCP": "10",
      "TLS": "10",
      "UDP": "10"
    }
  },
  "success": true
}
```

## Get DNS queries by type summary

`client.radar.dns.summary.queryType(SummaryQueryTypeParamsquery?, RequestOptionsoptions?): SummaryQueryTypeResponse`

**get** `/radar/dns/summary/query_type`

Retrieves the distribution of DNS queries by type.

### Parameters

- `query: SummaryQueryTypeParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `limitPerGroup?: number`

    Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryQueryTypeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Record<string, string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.queryType();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "A": "20",
      "AAAA": "20",
      "HTTPS": "20",
      "NS": "20",
      "PTR": "20"
    }
  },
  "success": true
}
```

## Get DNS queries by response code summary

`client.radar.dns.summary.responseCode(SummaryResponseCodeParamsquery?, RequestOptionsoptions?): SummaryResponseCodeResponse`

**get** `/radar/dns/summary/response_code`

Retrieves the distribution of DNS queries by response code.

### Parameters

- `query: SummaryResponseCodeParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `limitPerGroup?: number`

    Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryResponseCodeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Record<string, string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.responseCode();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "NOERROR": "70",
      "NOTIMP": "5",
      "NXDOMAIN": "10",
      "REFUSED": "5",
      "SERVFAIL": "5"
    }
  },
  "success": true
}
```

## Get DNS queries by response TTL summary

`client.radar.dns.summary.responseTTL(SummaryResponseTTLParamsquery?, RequestOptionsoptions?): SummaryResponseTTLResponse`

**get** `/radar/dns/summary/response_ttl`

Retrieves the distribution of DNS queries by minimum response TTL.

### Parameters

- `query: SummaryResponseTTLParams`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `SummaryResponseTTLResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `gt_15m_lte_1h: string`

      A numeric string.

    - `gt_1d_lte_1w: string`

      A numeric string.

    - `gt_1h_lte_1d: string`

      A numeric string.

    - `gt_1m_lte_5m: string`

      A numeric string.

    - `gt_1w: string`

      A numeric string.

    - `gt_5m_lte_15m: string`

      A numeric string.

    - `lte_1m: string`

      A numeric string.

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.summary.responseTTL();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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"
        }
      ]
    },
    "summary_0": {
      "gt_15m_lte_1h": "10",
      "gt_1d_lte_1w": "10",
      "gt_1h_lte_1d": "10",
      "gt_1m_lte_5m": "10",
      "gt_1w": "10",
      "gt_5m_lte_15m": "10",
      "lte_1m": "10"
    }
  },
  "success": true
}
```

## Domain Types

### Summary Cache Hit Response

- `SummaryCacheHitResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NEGATIVE: string`

      A numeric string.

    - `POSITIVE: string`

      A numeric string.

### Summary DNSSEC Response

- `SummaryDNSSECResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `INSECURE: string`

      A numeric string.

    - `INVALID: string`

      A numeric string.

    - `OTHER: string`

      A numeric string.

    - `SECURE: string`

      A numeric string.

### Summary DNSSEC Aware Response

- `SummaryDNSSECAwareResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NOT_SUPPORTED: string`

      A numeric string.

    - `SUPPORTED: string`

      A numeric string.

### Summary DNSSEC E2E Response

- `SummaryDNSSECE2EResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NEGATIVE: string`

      A numeric string.

    - `POSITIVE: string`

      A numeric string.

### Summary IP Version Response

- `SummaryIPVersionResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `IPv4: string`

      A numeric string.

    - `IPv6: string`

      A numeric string.

### Summary Matching Answer Response

- `SummaryMatchingAnswerResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `NEGATIVE: string`

      A numeric string.

    - `POSITIVE: string`

      A numeric string.

### Summary Protocol Response

- `SummaryProtocolResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `HTTPS: string`

      A numeric string.

    - `TCP: string`

      A numeric string.

    - `TLS: string`

      A numeric string.

    - `UDP: string`

      A numeric string.

### Summary Query Type Response

- `SummaryQueryTypeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Record<string, string>`

### Summary Response Code Response

- `SummaryResponseCodeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Record<string, string>`

### Summary Response TTL Response

- `SummaryResponseTTLResponse`

  - `meta: Meta`

    Metadata for the results.

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `summary_0: Summary0`

    - `gt_15m_lte_1h: string`

      A numeric string.

    - `gt_1d_lte_1w: string`

      A numeric string.

    - `gt_1h_lte_1d: string`

      A numeric string.

    - `gt_1m_lte_5m: string`

      A numeric string.

    - `gt_1w: string`

      A numeric string.

    - `gt_5m_lte_15m: string`

      A numeric string.

    - `lte_1m: string`

      A numeric string.

# Timeseries Groups

## Get DNS queries by cache status time series

`client.radar.dns.timeseriesGroups.cacheHit(TimeseriesGroupCacheHitParamsquery?, RequestOptionsoptions?): TimeseriesGroupCacheHitResponse`

**get** `/radar/dns/timeseries_groups/cache_hit`

Retrieves the distribution of DNS queries by cache status over time.

### Parameters

- `query: TimeseriesGroupCacheHitParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupCacheHitResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NEGATIVE: Array<string>`

    - `POSITIVE: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.cacheHit();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "NEGATIVE": [
        "10"
      ],
      "POSITIVE": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by DNSSEC support time series

`client.radar.dns.timeseriesGroups.dnssec(TimeseriesGroupDNSSECParamsquery?, RequestOptionsoptions?): TimeseriesGroupDNSSECResponse`

**get** `/radar/dns/timeseries_groups/dnssec`

Retrieves the distribution of DNS responses by DNSSEC (DNS Security Extensions) support over time.

### Parameters

- `query: TimeseriesGroupDNSSECParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupDNSSECResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `INSECURE: Array<string>`

    - `INVALID: Array<string>`

    - `OTHER: Array<string>`

    - `SECURE: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.dnssec();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "INSECURE": [
        "10"
      ],
      "INVALID": [
        "10"
      ],
      "OTHER": [
        "10"
      ],
      "SECURE": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by DNSSEC awareness time series

`client.radar.dns.timeseriesGroups.dnssecAware(TimeseriesGroupDNSSECAwareParamsquery?, RequestOptionsoptions?): TimeseriesGroupDNSSECAwareResponse`

**get** `/radar/dns/timeseries_groups/dnssec_aware`

Retrieves the distribution of DNS queries by DNSSEC (DNS Security Extensions) client awareness over time.

### Parameters

- `query: TimeseriesGroupDNSSECAwareParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupDNSSECAwareResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NOT_SUPPORTED: Array<string>`

    - `SUPPORTED: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.dnssecAware();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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
}
```

## Get DNS queries by DNSSEC end-to-end time series

`client.radar.dns.timeseriesGroups.dnssecE2E(TimeseriesGroupDNSSECE2EParamsquery?, RequestOptionsoptions?): TimeseriesGroupDNSSECE2EResponse`

**get** `/radar/dns/timeseries_groups/dnssec_e2e`

Retrieves the distribution of DNSSEC-validated answers by end-to-end security status over time.

### Parameters

- `query: TimeseriesGroupDNSSECE2EParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupDNSSECE2EResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NEGATIVE: Array<string>`

    - `POSITIVE: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.dnssecE2E();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "NEGATIVE": [
        "10"
      ],
      "POSITIVE": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by IP version time series

`client.radar.dns.timeseriesGroups.ipVersion(TimeseriesGroupIPVersionParamsquery?, RequestOptionsoptions?): TimeseriesGroupIPVersionResponse`

**get** `/radar/dns/timeseries_groups/ip_version`

Retrieves the distribution of DNS queries by IP version over time.

### Parameters

- `query: TimeseriesGroupIPVersionParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupIPVersionResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `IPv4: Array<string>`

    - `IPv6: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.ipVersion();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "IPv4": [
        "10"
      ],
      "IPv6": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by matching answer time series

`client.radar.dns.timeseriesGroups.matchingAnswer(TimeseriesGroupMatchingAnswerParamsquery?, RequestOptionsoptions?): TimeseriesGroupMatchingAnswerResponse`

**get** `/radar/dns/timeseries_groups/matching_answer`

Retrieves the distribution of DNS queries by matching answers over time.

### Parameters

- `query: TimeseriesGroupMatchingAnswerParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupMatchingAnswerResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NEGATIVE: Array<string>`

    - `POSITIVE: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.matchingAnswer();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "NEGATIVE": [
        "10"
      ],
      "POSITIVE": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by protocol time series

`client.radar.dns.timeseriesGroups.protocol(TimeseriesGroupProtocolParamsquery?, RequestOptionsoptions?): TimeseriesGroupProtocolResponse`

**get** `/radar/dns/timeseries_groups/protocol`

Retrieves the distribution of DNS queries by DNS transport protocol over time.

### Parameters

- `query: TimeseriesGroupProtocolParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupProtocolResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `HTTPS: Array<string>`

    - `TCP: Array<string>`

    - `TLS: Array<string>`

    - `UDP: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.protocol();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "HTTPS": [
        "10"
      ],
      "TCP": [
        "10"
      ],
      "TLS": [
        "10"
      ],
      "UDP": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by type time series

`client.radar.dns.timeseriesGroups.queryType(TimeseriesGroupQueryTypeParamsquery?, RequestOptionsoptions?): TimeseriesGroupQueryTypeResponse`

**get** `/radar/dns/timeseries_groups/query_type`

Retrieves the distribution of DNS queries by type over time.

### Parameters

- `query: TimeseriesGroupQueryTypeParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `limitPerGroup?: number`

    Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupQueryTypeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `timestamps: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.queryType();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by response code time series

`client.radar.dns.timeseriesGroups.responseCode(TimeseriesGroupResponseCodeParamsquery?, RequestOptionsoptions?): TimeseriesGroupResponseCodeResponse`

**get** `/radar/dns/timeseries_groups/response_code`

Retrieves the distribution of DNS queries by response code over time.

### Parameters

- `query: TimeseriesGroupResponseCodeParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `limitPerGroup?: number`

    Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupResponseCodeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `timestamps: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.responseCode();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "success": true
}
```

## Get DNS queries by response TTL time series

`client.radar.dns.timeseriesGroups.responseTTL(TimeseriesGroupResponseTTLParamsquery?, RequestOptionsoptions?): TimeseriesGroupResponseTTLResponse`

**get** `/radar/dns/timeseries_groups/response_ttl`

Retrieves the distribution of DNS queries by minimum answer TTL over time.

### Parameters

- `query: TimeseriesGroupResponseTTLParams`

  - `aggInterval?: "15m" | "1h" | "1d" | "1w"`

    Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

    - `"15m"`

    - `"1h"`

    - `"1d"`

    - `"1w"`

  - `asn?: Array<string>`

    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.

  - `continent?: Array<string>`

    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.

  - `dateEnd?: Array<string>`

    End of the date range (inclusive).

  - `dateRange?: Array<string>`

    Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).

  - `dateStart?: Array<string>`

    Start of the date range.

  - `format?: "JSON" | "CSV"`

    Format in which results will be returned.

    - `"JSON"`

    - `"CSV"`

  - `location?: Array<string>`

    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.

  - `name?: Array<string>`

    Array of names used to label the series in the response.

  - `nodata?: Array<boolean>`

    Specifies whether the response includes empty DNS responses (NODATA).

  - `protocol?: Array<"UDP" | "TCP" | "HTTPS" | "TLS">`

    Filters results by DNS transport protocol.

    - `"UDP"`

    - `"TCP"`

    - `"HTTPS"`

    - `"TLS"`

  - `queryType?: Array<"A" | "AAAA" | "A6" | 85 more | null>`

    Filters results by DNS query type.

    - `"A"`

    - `"AAAA"`

    - `"A6"`

    - `"AFSDB"`

    - `"ANY"`

    - `"APL"`

    - `"ATMA"`

    - `"AXFR"`

    - `"CAA"`

    - `"CDNSKEY"`

    - `"CDS"`

    - `"CERT"`

    - `"CNAME"`

    - `"CSYNC"`

    - `"DHCID"`

    - `"DLV"`

    - `"DNAME"`

    - `"DNSKEY"`

    - `"DOA"`

    - `"DS"`

    - `"EID"`

    - `"EUI48"`

    - `"EUI64"`

    - `"GPOS"`

    - `"GID"`

    - `"HINFO"`

    - `"HIP"`

    - `"HTTPS"`

    - `"IPSECKEY"`

    - `"ISDN"`

    - `"IXFR"`

    - `"KEY"`

    - `"KX"`

    - `"L32"`

    - `"L64"`

    - `"LOC"`

    - `"LP"`

    - `"MAILA"`

    - `"MAILB"`

    - `"MB"`

    - `"MD"`

    - `"MF"`

    - `"MG"`

    - `"MINFO"`

    - `"MR"`

    - `"MX"`

    - `"NAPTR"`

    - `"NB"`

    - `"NBSTAT"`

    - `"NID"`

    - `"NIMLOC"`

    - `"NINFO"`

    - `"NS"`

    - `"NSAP"`

    - `"NSEC"`

    - `"NSEC3"`

    - `"NSEC3PARAM"`

    - `"NULL"`

    - `"NXT"`

    - `"OPENPGPKEY"`

    - `"OPT"`

    - `"PTR"`

    - `"PX"`

    - `"RKEY"`

    - `"RP"`

    - `"RRSIG"`

    - `"RT"`

    - `"SIG"`

    - `"SINK"`

    - `"SMIMEA"`

    - `"SOA"`

    - `"SPF"`

    - `"SRV"`

    - `"SSHFP"`

    - `"SVCB"`

    - `"TA"`

    - `"TALINK"`

    - `"TKEY"`

    - `"TLSA"`

    - `"TSIG"`

    - `"TXT"`

    - `"UINFO"`

    - `"UID"`

    - `"UNSPEC"`

    - `"URI"`

    - `"WKS"`

    - `"X25"`

    - `"ZONEMD"`

  - `responseCode?: Array<"NOERROR" | "FORMERR" | "SERVFAIL" | 16 more>`

    Filters results by DNS response code.

    - `"NOERROR"`

    - `"FORMERR"`

    - `"SERVFAIL"`

    - `"NXDOMAIN"`

    - `"NOTIMP"`

    - `"REFUSED"`

    - `"YXDOMAIN"`

    - `"YXRRSET"`

    - `"NXRRSET"`

    - `"NOTAUTH"`

    - `"NOTZONE"`

    - `"BADSIG"`

    - `"BADKEY"`

    - `"BADTIME"`

    - `"BADMODE"`

    - `"BADNAME"`

    - `"BADALG"`

    - `"BADTRUNC"`

    - `"BADCOOKIE"`

  - `tld?: Array<string>`

    Filters results by top-level domain.

### Returns

- `TimeseriesGroupResponseTTLResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `gt_15m_lte_1h: Array<string>`

    - `gt_1d_lte_1w: Array<string>`

    - `gt_1h_lte_1d: Array<string>`

    - `gt_1m_lte_5m: Array<string>`

    - `gt_1w: Array<string>`

    - `gt_5m_lte_15m: Array<string>`

    - `lte_1m: Array<string>`

### Example

```node
import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const response = await client.radar.dns.timeseriesGroups.responseTTL();

console.log(response.meta);
```

#### Response

```json
{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "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": {
      "gt_15m_lte_1h": [
        "10"
      ],
      "gt_1d_lte_1w": [
        "10"
      ],
      "gt_1h_lte_1d": [
        "10"
      ],
      "gt_1m_lte_5m": [
        "10"
      ],
      "gt_1w": [
        "10"
      ],
      "gt_5m_lte_15m": [
        "10"
      ],
      "lte_1m": [
        "10"
      ]
    }
  },
  "success": true
}
```

## Domain Types

### Timeseries Group Cache Hit Response

- `TimeseriesGroupCacheHitResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NEGATIVE: Array<string>`

    - `POSITIVE: Array<string>`

### Timeseries Group DNSSEC Response

- `TimeseriesGroupDNSSECResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `INSECURE: Array<string>`

    - `INVALID: Array<string>`

    - `OTHER: Array<string>`

    - `SECURE: Array<string>`

### Timeseries Group DNSSEC Aware Response

- `TimeseriesGroupDNSSECAwareResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NOT_SUPPORTED: Array<string>`

    - `SUPPORTED: Array<string>`

### Timeseries Group DNSSEC E2E Response

- `TimeseriesGroupDNSSECE2EResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NEGATIVE: Array<string>`

    - `POSITIVE: Array<string>`

### Timeseries Group IP Version Response

- `TimeseriesGroupIPVersionResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `IPv4: Array<string>`

    - `IPv6: Array<string>`

### Timeseries Group Matching Answer Response

- `TimeseriesGroupMatchingAnswerResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `NEGATIVE: Array<string>`

    - `POSITIVE: Array<string>`

### Timeseries Group Protocol Response

- `TimeseriesGroupProtocolResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `HTTPS: Array<string>`

    - `TCP: Array<string>`

    - `TLS: Array<string>`

    - `UDP: Array<string>`

### Timeseries Group Query Type Response

- `TimeseriesGroupQueryTypeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `timestamps: Array<string>`

### Timeseries Group Response Code Response

- `TimeseriesGroupResponseCodeResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `timestamps: Array<string>`

### Timeseries Group Response TTL Response

- `TimeseriesGroupResponseTTLResponse`

  - `meta: Meta`

    Metadata for the results.

    - `aggInterval: "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](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).

      - `"FIFTEEN_MINUTES"`

      - `"ONE_HOUR"`

      - `"ONE_DAY"`

      - `"ONE_WEEK"`

      - `"ONE_MONTH"`

    - `confidenceInfo: ConfidenceInfo`

      - `annotations: Array<Annotation>`

        - `dataSource: "ALL" | "AI_BOTS" | "AI_GATEWAY" | 22 more`

          Data source for annotations.

          - `"ALL"`

          - `"AI_BOTS"`

          - `"AI_GATEWAY"`

          - `"BGP"`

          - `"BOTS"`

          - `"CONNECTION_ANOMALY"`

          - `"CT"`

          - `"DNS"`

          - `"DNS_MAGNITUDE"`

          - `"DNS_AS112"`

          - `"DOS"`

          - `"EMAIL_ROUTING"`

          - `"EMAIL_SECURITY"`

          - `"FW"`

          - `"FW_PG"`

          - `"HTTP"`

          - `"HTTP_CONTROL"`

          - `"HTTP_CRAWLER_REFERER"`

          - `"HTTP_ORIGINS"`

          - `"IQI"`

          - `"LEAKED_CREDENTIALS"`

          - `"NET"`

          - `"ROBOTS_TXT"`

          - `"SPEED"`

          - `"WORKERS_AI"`

        - `description: string`

        - `endDate: string`

        - `eventType: "EVENT" | "GENERAL" | "OUTAGE" | 3 more`

          Event type for annotations.

          - `"EVENT"`

          - `"GENERAL"`

          - `"OUTAGE"`

          - `"PARTIAL_PROJECTION"`

          - `"PIPELINE"`

          - `"TRAFFIC_ANOMALY"`

        - `isInstantaneous: boolean`

          Whether event is a single point in time or a time range.

        - `linkedUrl: string`

        - `startDate: string`

      - `level: number`

        Provides an indication of how much confidence Cloudflare has in the data.

    - `dateRange: Array<DateRange>`

      - `endTime: string`

        Adjusted end of date range.

      - `startTime: string`

        Adjusted start of date range.

    - `lastUpdated: string`

      Timestamp of the last dataset update.

    - `normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | 5 more`

      Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).

      - `"PERCENTAGE"`

      - `"MIN0_MAX"`

      - `"MIN_MAX"`

      - `"RAW_VALUES"`

      - `"PERCENTAGE_CHANGE"`

      - `"ROLLING_AVERAGE"`

      - `"OVERLAPPED_PERCENTAGE"`

      - `"RATIO"`

    - `units: Array<Unit>`

      Measurement units for the results.

      - `name: string`

      - `value: string`

  - `serie_0: Serie0`

    - `gt_15m_lte_1h: Array<string>`

    - `gt_1d_lte_1w: Array<string>`

    - `gt_1h_lte_1d: Array<string>`

    - `gt_1m_lte_5m: Array<string>`

    - `gt_1w: Array<string>`

    - `gt_5m_lte_15m: Array<string>`

    - `lte_1m: Array<string>`