--- title: Get DNS queries time series --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Radar](https://developers.cloudflare.com/api/go/resources/radar) [DNS](https://developers.cloudflare.com/api/go/resources/radar/subresources/dns) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get DNS queries time series client.Radar.DNS.Timeseries(ctx, query) (\*[DNSTimeseriesResponse](), error) GET/radar/dns/timeseries Retrieves normalized query volume to the 1.1.1.1 DNS resolver over time. ##### Security

API Token

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

API Email + API Key

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

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

query DNSTimeseriesParams

AggInterval param.Field\[DNSTimeseriesParamsAggInterval]Optional Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals. When omitted, the interval is auto-selected from the requested date range; finer intervals are only available for shorter ranges. If the requested interval is too granular for the date range, the request is rejected.

const DNSTimeseriesParamsAggInterval15m DNSTimeseriesParamsAggInterval = "15m" Link to this property const DNSTimeseriesParamsAggInterval1h DNSTimeseriesParamsAggInterval = "1h" Link to this property const DNSTimeseriesParamsAggInterval1d DNSTimeseriesParamsAggInterval = "1d" Link to this property const DNSTimeseriesParamsAggInterval1w DNSTimeseriesParamsAggInterval = "1w" Link to this property

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

DNSSEC param.Field\[\[]DNSTimeseriesParamsDNSSEC]Optional Filters results based on DNSSEC (DNS Security Extensions) support.

const DNSTimeseriesParamsDNSSECInvalid DNSTimeseriesParamsDNSSEC = "INVALID" Link to this property const DNSTimeseriesParamsDNSSECInsecure DNSTimeseriesParamsDNSSEC = "INSECURE" Link to this property const DNSTimeseriesParamsDNSSECSecure DNSTimeseriesParamsDNSSEC = "SECURE" Link to this property const DNSTimeseriesParamsDNSSECOther DNSTimeseriesParamsDNSSEC = "OTHER" Link to this property

Link to this property

DNSSECAware param.Field\[\[]DNSTimeseriesParamsDNSSECAware]Optional Filters results based on DNSSEC (DNS Security Extensions) client awareness.

const DNSTimeseriesParamsDNSSECAwareSupported DNSTimeseriesParamsDNSSECAware = "SUPPORTED" Link to this property const DNSTimeseriesParamsDNSSECAwareNotSupported DNSTimeseriesParamsDNSSECAware = "NOT\_SUPPORTED" Link to this property

Link to this property DNSSECE2E param.Field\[\[]bool]Optional Filters results based on DNSSEC-validated answers by end-to-end security status. Link to this property

Format param.Field\[DNSTimeseriesParamsFormat]Optional Format in which results will be returned.

const DNSTimeseriesParamsFormatJson DNSTimeseriesParamsFormat = "JSON" Link to this property const DNSTimeseriesParamsFormatCsv DNSTimeseriesParamsFormat = "CSV" Link to this property

Link to this property

IPVersion param.Field\[\[]DNSTimeseriesParamsIPVersion]Optional Filters results by IP version (Ipv4 vs. IPv6).

const DNSTimeseriesParamsIPVersionIPv4 DNSTimeseriesParamsIPVersion = "IPv4" Link to this property const DNSTimeseriesParamsIPVersionIPv6 DNSTimeseriesParamsIPVersion = "IPv6" Link to this property

Link to this property Location param.Field\[\[]string]Optional Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude locations from results. For example, -US,PT excludes results from the US, but includes results from PT. Link to this property MatchingAnswer param.Field\[\[]bool]Optional Filters results based on whether the queries have a matching answer. Link to this property Name param.Field\[\[]string]Optional Array of names used to label the series in the response. Link to this property Nodata param.Field\[\[]bool]Optional Specifies whether the response includes empty DNS responses (NODATA). Link to this property

Protocol param.Field\[\[]DNSTimeseriesParamsProtocol]Optional Filters results by DNS transport protocol.

const DNSTimeseriesParamsProtocolUdp DNSTimeseriesParamsProtocol = "UDP" Link to this property const DNSTimeseriesParamsProtocolTCP DNSTimeseriesParamsProtocol = "TCP" Link to this property const DNSTimeseriesParamsProtocolHTTPS DNSTimeseriesParamsProtocol = "HTTPS" Link to this property const DNSTimeseriesParamsProtocolTLS DNSTimeseriesParamsProtocol = "TLS" Link to this property

Link to this property

QueryType param.Field\[\[]DNSTimeseriesParamsQueryType]Optional Filters results by DNS query type.

const DNSTimeseriesParamsQueryTypeA DNSTimeseriesParamsQueryType = "A" Link to this property const DNSTimeseriesParamsQueryTypeAAAA DNSTimeseriesParamsQueryType = "AAAA" Link to this property const DNSTimeseriesParamsQueryTypeA6 DNSTimeseriesParamsQueryType = "A6" Link to this property const DNSTimeseriesParamsQueryTypeAfsdb DNSTimeseriesParamsQueryType = "AFSDB" Link to this property const DNSTimeseriesParamsQueryTypeAny DNSTimeseriesParamsQueryType = "ANY" Link to this property const DNSTimeseriesParamsQueryTypeApl DNSTimeseriesParamsQueryType = "APL" Link to this property const DNSTimeseriesParamsQueryTypeAtma DNSTimeseriesParamsQueryType = "ATMA" Link to this property const DNSTimeseriesParamsQueryTypeAXFR DNSTimeseriesParamsQueryType = "AXFR" Link to this property const DNSTimeseriesParamsQueryTypeCAA DNSTimeseriesParamsQueryType = "CAA" Link to this property const DNSTimeseriesParamsQueryTypeCdnskey DNSTimeseriesParamsQueryType = "CDNSKEY" Link to this property const DNSTimeseriesParamsQueryTypeCds DNSTimeseriesParamsQueryType = "CDS" Link to this property const DNSTimeseriesParamsQueryTypeCERT DNSTimeseriesParamsQueryType = "CERT" Link to this property const DNSTimeseriesParamsQueryTypeCNAME DNSTimeseriesParamsQueryType = "CNAME" Link to this property const DNSTimeseriesParamsQueryTypeCsync DNSTimeseriesParamsQueryType = "CSYNC" Link to this property const DNSTimeseriesParamsQueryTypeDhcid DNSTimeseriesParamsQueryType = "DHCID" Link to this property const DNSTimeseriesParamsQueryTypeDlv DNSTimeseriesParamsQueryType = "DLV" Link to this property const DNSTimeseriesParamsQueryTypeDname DNSTimeseriesParamsQueryType = "DNAME" Link to this property const DNSTimeseriesParamsQueryTypeDNSKEY DNSTimeseriesParamsQueryType = "DNSKEY" Link to this property const DNSTimeseriesParamsQueryTypeDoa DNSTimeseriesParamsQueryType = "DOA" Link to this property const DNSTimeseriesParamsQueryTypeDS DNSTimeseriesParamsQueryType = "DS" Link to this property const DNSTimeseriesParamsQueryTypeEid DNSTimeseriesParamsQueryType = "EID" Link to this property const DNSTimeseriesParamsQueryTypeEui48 DNSTimeseriesParamsQueryType = "EUI48" Link to this property const DNSTimeseriesParamsQueryTypeEui64 DNSTimeseriesParamsQueryType = "EUI64" Link to this property const DNSTimeseriesParamsQueryTypeGpos DNSTimeseriesParamsQueryType = "GPOS" Link to this property const DNSTimeseriesParamsQueryTypeGid DNSTimeseriesParamsQueryType = "GID" Link to this property const DNSTimeseriesParamsQueryTypeHinfo DNSTimeseriesParamsQueryType = "HINFO" Link to this property const DNSTimeseriesParamsQueryTypeHip DNSTimeseriesParamsQueryType = "HIP" Link to this property const DNSTimeseriesParamsQueryTypeHTTPS DNSTimeseriesParamsQueryType = "HTTPS" Link to this property const DNSTimeseriesParamsQueryTypeIpseckey DNSTimeseriesParamsQueryType = "IPSECKEY" Link to this property const DNSTimeseriesParamsQueryTypeIsdn DNSTimeseriesParamsQueryType = "ISDN" Link to this property const DNSTimeseriesParamsQueryTypeIxfr DNSTimeseriesParamsQueryType = "IXFR" Link to this property const DNSTimeseriesParamsQueryTypeKey DNSTimeseriesParamsQueryType = "KEY" Link to this property const DNSTimeseriesParamsQueryTypeKx DNSTimeseriesParamsQueryType = "KX" Link to this property const DNSTimeseriesParamsQueryTypeL32 DNSTimeseriesParamsQueryType = "L32" Link to this property const DNSTimeseriesParamsQueryTypeL64 DNSTimeseriesParamsQueryType = "L64" Link to this property const DNSTimeseriesParamsQueryTypeLOC DNSTimeseriesParamsQueryType = "LOC" Link to this property const DNSTimeseriesParamsQueryTypeLp DNSTimeseriesParamsQueryType = "LP" Link to this property const DNSTimeseriesParamsQueryTypeMaila DNSTimeseriesParamsQueryType = "MAILA" Link to this property const DNSTimeseriesParamsQueryTypeMailb DNSTimeseriesParamsQueryType = "MAILB" Link to this property const DNSTimeseriesParamsQueryTypeMB DNSTimeseriesParamsQueryType = "MB" Link to this property const DNSTimeseriesParamsQueryTypeMd DNSTimeseriesParamsQueryType = "MD" Link to this property const DNSTimeseriesParamsQueryTypeMf DNSTimeseriesParamsQueryType = "MF" Link to this property const DNSTimeseriesParamsQueryTypeMg DNSTimeseriesParamsQueryType = "MG" Link to this property const DNSTimeseriesParamsQueryTypeMinfo DNSTimeseriesParamsQueryType = "MINFO" Link to this property const DNSTimeseriesParamsQueryTypeMr DNSTimeseriesParamsQueryType = "MR" Link to this property const DNSTimeseriesParamsQueryTypeMX DNSTimeseriesParamsQueryType = "MX" Link to this property const DNSTimeseriesParamsQueryTypeNAPTR DNSTimeseriesParamsQueryType = "NAPTR" Link to this property const DNSTimeseriesParamsQueryTypeNb DNSTimeseriesParamsQueryType = "NB" Link to this property const DNSTimeseriesParamsQueryTypeNbstat DNSTimeseriesParamsQueryType = "NBSTAT" Link to this property const DNSTimeseriesParamsQueryTypeNid DNSTimeseriesParamsQueryType = "NID" Link to this property const DNSTimeseriesParamsQueryTypeNimloc DNSTimeseriesParamsQueryType = "NIMLOC" Link to this property const DNSTimeseriesParamsQueryTypeNinfo DNSTimeseriesParamsQueryType = "NINFO" Link to this property const DNSTimeseriesParamsQueryTypeNS DNSTimeseriesParamsQueryType = "NS" Link to this property const DNSTimeseriesParamsQueryTypeNsap DNSTimeseriesParamsQueryType = "NSAP" Link to this property const DNSTimeseriesParamsQueryTypeNsec DNSTimeseriesParamsQueryType = "NSEC" Link to this property const DNSTimeseriesParamsQueryTypeNsec3 DNSTimeseriesParamsQueryType = "NSEC3" Link to this property const DNSTimeseriesParamsQueryTypeNsec3Param DNSTimeseriesParamsQueryType = "NSEC3PARAM" Link to this property const DNSTimeseriesParamsQueryTypeNull DNSTimeseriesParamsQueryType = "NULL" Link to this property const DNSTimeseriesParamsQueryTypeNxt DNSTimeseriesParamsQueryType = "NXT" Link to this property const DNSTimeseriesParamsQueryTypeOpenpgpkey DNSTimeseriesParamsQueryType = "OPENPGPKEY" Link to this property const DNSTimeseriesParamsQueryTypeOpt DNSTimeseriesParamsQueryType = "OPT" Link to this property const DNSTimeseriesParamsQueryTypePTR DNSTimeseriesParamsQueryType = "PTR" Link to this property const DNSTimeseriesParamsQueryTypePx DNSTimeseriesParamsQueryType = "PX" Link to this property const DNSTimeseriesParamsQueryTypeRkey DNSTimeseriesParamsQueryType = "RKEY" Link to this property const DNSTimeseriesParamsQueryTypeRp DNSTimeseriesParamsQueryType = "RP" Link to this property const DNSTimeseriesParamsQueryTypeRrsig DNSTimeseriesParamsQueryType = "RRSIG" Link to this property const DNSTimeseriesParamsQueryTypeRt DNSTimeseriesParamsQueryType = "RT" Link to this property const DNSTimeseriesParamsQueryTypeSig DNSTimeseriesParamsQueryType = "SIG" Link to this property const DNSTimeseriesParamsQueryTypeSink DNSTimeseriesParamsQueryType = "SINK" Link to this property const DNSTimeseriesParamsQueryTypeSMIMEA DNSTimeseriesParamsQueryType = "SMIMEA" Link to this property const DNSTimeseriesParamsQueryTypeSOA DNSTimeseriesParamsQueryType = "SOA" Link to this property const DNSTimeseriesParamsQueryTypeSPF DNSTimeseriesParamsQueryType = "SPF" Link to this property const DNSTimeseriesParamsQueryTypeSRV DNSTimeseriesParamsQueryType = "SRV" Link to this property const DNSTimeseriesParamsQueryTypeSSHFP DNSTimeseriesParamsQueryType = "SSHFP" Link to this property const DNSTimeseriesParamsQueryTypeSVCB DNSTimeseriesParamsQueryType = "SVCB" Link to this property const DNSTimeseriesParamsQueryTypeTa DNSTimeseriesParamsQueryType = "TA" Link to this property const DNSTimeseriesParamsQueryTypeTalink DNSTimeseriesParamsQueryType = "TALINK" Link to this property const DNSTimeseriesParamsQueryTypeTkey DNSTimeseriesParamsQueryType = "TKEY" Link to this property const DNSTimeseriesParamsQueryTypeTLSA DNSTimeseriesParamsQueryType = "TLSA" Link to this property const DNSTimeseriesParamsQueryTypeTSIG DNSTimeseriesParamsQueryType = "TSIG" Link to this property const DNSTimeseriesParamsQueryTypeTXT DNSTimeseriesParamsQueryType = "TXT" Link to this property const DNSTimeseriesParamsQueryTypeUinfo DNSTimeseriesParamsQueryType = "UINFO" Link to this property const DNSTimeseriesParamsQueryTypeUID DNSTimeseriesParamsQueryType = "UID" Link to this property const DNSTimeseriesParamsQueryTypeUnspec DNSTimeseriesParamsQueryType = "UNSPEC" Link to this property const DNSTimeseriesParamsQueryTypeURI DNSTimeseriesParamsQueryType = "URI" Link to this property const DNSTimeseriesParamsQueryTypeWks DNSTimeseriesParamsQueryType = "WKS" Link to this property const DNSTimeseriesParamsQueryTypeX25 DNSTimeseriesParamsQueryType = "X25" Link to this property const DNSTimeseriesParamsQueryTypeZonemd DNSTimeseriesParamsQueryType = "ZONEMD" Link to this property

Link to this property

ResponseCode param.Field\[\[]DNSTimeseriesParamsResponseCode]Optional Filters results by DNS response code.

const DNSTimeseriesParamsResponseCodeNoerror DNSTimeseriesParamsResponseCode = "NOERROR" Link to this property const DNSTimeseriesParamsResponseCodeFormerr DNSTimeseriesParamsResponseCode = "FORMERR" Link to this property const DNSTimeseriesParamsResponseCodeServfail DNSTimeseriesParamsResponseCode = "SERVFAIL" Link to this property const DNSTimeseriesParamsResponseCodeNxdomain DNSTimeseriesParamsResponseCode = "NXDOMAIN" Link to this property const DNSTimeseriesParamsResponseCodeNotimp DNSTimeseriesParamsResponseCode = "NOTIMP" Link to this property const DNSTimeseriesParamsResponseCodeRefused DNSTimeseriesParamsResponseCode = "REFUSED" Link to this property const DNSTimeseriesParamsResponseCodeYxdomain DNSTimeseriesParamsResponseCode = "YXDOMAIN" Link to this property const DNSTimeseriesParamsResponseCodeYxrrset DNSTimeseriesParamsResponseCode = "YXRRSET" Link to this property const DNSTimeseriesParamsResponseCodeNxrrset DNSTimeseriesParamsResponseCode = "NXRRSET" Link to this property const DNSTimeseriesParamsResponseCodeNotauth DNSTimeseriesParamsResponseCode = "NOTAUTH" Link to this property const DNSTimeseriesParamsResponseCodeNotzone DNSTimeseriesParamsResponseCode = "NOTZONE" Link to this property const DNSTimeseriesParamsResponseCodeBadsig DNSTimeseriesParamsResponseCode = "BADSIG" Link to this property const DNSTimeseriesParamsResponseCodeBadkey DNSTimeseriesParamsResponseCode = "BADKEY" Link to this property const DNSTimeseriesParamsResponseCodeBadtime DNSTimeseriesParamsResponseCode = "BADTIME" Link to this property const DNSTimeseriesParamsResponseCodeBadmode DNSTimeseriesParamsResponseCode = "BADMODE" Link to this property const DNSTimeseriesParamsResponseCodeBadname DNSTimeseriesParamsResponseCode = "BADNAME" Link to this property const DNSTimeseriesParamsResponseCodeBadalg DNSTimeseriesParamsResponseCode = "BADALG" Link to this property const DNSTimeseriesParamsResponseCodeBadtrunc DNSTimeseriesParamsResponseCode = "BADTRUNC" Link to this property const DNSTimeseriesParamsResponseCodeBadcookie DNSTimeseriesParamsResponseCode = "BADCOOKIE" Link to this property

Link to this property

ResponseTTL param.Field\[\[]DNSTimeseriesParamsResponseTTL]Optional Filters results by DNS response TTL.

const DNSTimeseriesParamsResponseTTLLte1M DNSTimeseriesParamsResponseTTL = "LTE\_1M" Link to this property const DNSTimeseriesParamsResponseTTLGt1MLte5M DNSTimeseriesParamsResponseTTL = "GT\_1M\_LTE\_5M" Link to this property const DNSTimeseriesParamsResponseTTLGt5MLte15M DNSTimeseriesParamsResponseTTL = "GT\_5M\_LTE\_15M" Link to this property const DNSTimeseriesParamsResponseTTLGt15MLte1H DNSTimeseriesParamsResponseTTL = "GT\_15M\_LTE\_1H" Link to this property const DNSTimeseriesParamsResponseTTLGt1HLte1D DNSTimeseriesParamsResponseTTL = "GT\_1H\_LTE\_1D" Link to this property const DNSTimeseriesParamsResponseTTLGt1DLte1W DNSTimeseriesParamsResponseTTL = "GT\_1D\_LTE\_1W" Link to this property const DNSTimeseriesParamsResponseTTLGt1W DNSTimeseriesParamsResponseTTL = "GT\_1W" Link to this property

Link to this property TLD param.Field\[\[]string]Optional Filters results by top-level domain. Incompatible with the ipVersion, protocol, dnssecE2e, dnssecAware, responseTtl, and cacheHit filters/dimensions; this restriction does not apply to country-code TLDs (2-letter, e.g. uk). Link to this property

[Link to this property](<#(resource)%20radar.dns%20%3E%20(method)%20timeseries%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type DNSTimeseriesResponse struct{…}

Meta DNSTimeseriesResponseMeta Metadata for the results.

AggInterval DNSTimeseriesResponseMetaAggInterval Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following: const DNSTimeseriesResponseMetaAggIntervalFifteenMinutes DNSTimeseriesResponseMetaAggInterval = "FIFTEEN\_MINUTES" Link to this property const DNSTimeseriesResponseMetaAggIntervalOneHour DNSTimeseriesResponseMetaAggInterval = "ONE\_HOUR" Link to this property const DNSTimeseriesResponseMetaAggIntervalOneDay DNSTimeseriesResponseMetaAggInterval = "ONE\_DAY" Link to this property const DNSTimeseriesResponseMetaAggIntervalOneWeek DNSTimeseriesResponseMetaAggInterval = "ONE\_WEEK" Link to this property const DNSTimeseriesResponseMetaAggIntervalOneMonth DNSTimeseriesResponseMetaAggInterval = "ONE\_MONTH" Link to this property

Link to this property

ConfidenceInfo DNSTimeseriesResponseMetaConfidenceInfo

Annotations \[]DNSTimeseriesResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource Data source for annotations.

One of the following: const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ALL" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI\_BOTS" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI\_GATEWAY" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BGP" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION\_ANOMALY" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CT" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS\_MAGNITUDE" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS\_AS112" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DOS" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL\_ROUTING" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL\_SECURITY" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW\_PG" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_CONTROL" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_CRAWLER\_REFERER" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP\_ORIGINS" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "IQI" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED\_CREDENTIALS" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "NET" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS\_TXT" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS\_AI" Link to this property

Link to this property Description string Link to this property EndDate Time formatdate-time Link to this property

EventType DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType Event type for annotations.

One of the following: const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL\_PROJECTION" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE" Link to this property const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC\_ANOMALY" Link to this property

Link to this property IsInstantaneous bool Whether event is a single point in time or a time range. Link to this property LinkedURL string formaturi Link to this property StartDate Time formatdate-time Link to this property Tags \[]stringOptional Link to this property

Link to this property Level int64 Provides an indication of how much confidence Cloudflare has in the data. Link to this property

Link to this property

DateRange \[]DNSTimeseriesResponseMetaDateRange

EndTime Time Adjusted end of date range. formatdate-time Link to this property StartTime Time Adjusted start of date range. formatdate-time Link to this property

Link to this property LastUpdated Time Timestamp of the last dataset update. formatdate-time Link to this property

Normalization DNSTimeseriesResponseMetaNormalization Normalization method applied to the results. Refer to Normalization methods.

One of the following: const DNSTimeseriesResponseMetaNormalizationPercentage DNSTimeseriesResponseMetaNormalization = "PERCENTAGE" Link to this property const DNSTimeseriesResponseMetaNormalizationMin0Max DNSTimeseriesResponseMetaNormalization = "MIN0\_MAX" Link to this property const DNSTimeseriesResponseMetaNormalizationMinMax DNSTimeseriesResponseMetaNormalization = "MIN\_MAX" Link to this property const DNSTimeseriesResponseMetaNormalizationRawValues DNSTimeseriesResponseMetaNormalization = "RAW\_VALUES" Link to this property const DNSTimeseriesResponseMetaNormalizationPercentageChange DNSTimeseriesResponseMetaNormalization = "PERCENTAGE\_CHANGE" Link to this property const DNSTimeseriesResponseMetaNormalizationRollingAverage DNSTimeseriesResponseMetaNormalization = "ROLLING\_AVERAGE" Link to this property const DNSTimeseriesResponseMetaNormalizationOverlappedPercentage DNSTimeseriesResponseMetaNormalization = "OVERLAPPED\_PERCENTAGE" Link to this property const DNSTimeseriesResponseMetaNormalizationRatio DNSTimeseriesResponseMetaNormalization = "RATIO" Link to this property

Link to this property

Units \[]DNSTimeseriesResponseMetaUnit Measurement units for the results.

Name string Link to this property Value string Link to this property

Link to this property

[Link to this property](<#(resource)%20radar.dns%20%3E%20(model)%20DNSTimeseriesResponse%20%3E%20(schema)>) ### Get DNS queries time series Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.Radar.DNS.Timeseries(context.TODO(), radar.DNSTimeseriesParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` 200 example ``` { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] } }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "GENERAL", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] } }, "success": true } ```