## Get AS112 DNS queries time series

`client.radar.as112.timeseries(AS112TimeseriesParamsquery?, RequestOptionsoptions?): AS112TimeseriesResponse`

**get** `/radar/as112/timeseries`

Retrieves the AS112 DNS queries over time.

### Parameters

- `query: AS112TimeseriesParams`

  - `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"`

  - `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.

  - `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"`

### Returns

- `AS112TimeseriesResponse`

  - `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.as112.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
}
```