Cloudflare API | Radar › DNS › Timeseries Groups › Get DNS Queries By Cache Status Time Series

Retrieves the top layer 3 attacks from origin to target location. Values are a percentage out of the total layer 3 attacks (with billing country). You can optionally limit the number of attacks by origin/target location (useful if all the top attacks are from or to the same location).

Get Top Industries Targeted By Layer 3 Attacks -> Envelope<{ meta, top_0 }>

Deprecated

get/radar/attacks/layer3/top/industry

This endpoint is deprecated. To continue getting this data, switch to the summary by industry endpoint.

Get Top Verticals Targeted By Layer 3 Attacks -> Envelope<{ meta, top_0 }>

Deprecated

get/radar/attacks/layer3/top/vertical

This endpoint is deprecated. To continue getting this data, switch to the summary by vertical endpoint.

Radar Attacks Layer3 Top

Locations

radar.attacks.layer3.top.locations

Methods

Get Top Origin Locations Of Layer 3 Attacks -> Envelope<{ meta, top_0 }>

get/radar/attacks/layer3/top/locations/origin

Retrieves the origin locations of layer 3 attacks.

Get Top Target Locations Of Layer 3 Attacks -> Envelope<{ meta, top_0 }>

get/radar/attacks/layer3/top/locations/target

Retrieves the target locations of layer 3 attacks.

Radar Attacks

Layer7

radar.attacks.layer7

Methods

Get Layer 7 Attacks Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries

Retrieves layer 7 attacks over time.

Radar Attacks Layer7

Summary

radar.attacks.layer7.summary

Methods

Get Layer 7 Attacks By HTTP Method Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/http_method

Retrieves the distribution of layer 7 attacks by HTTP method.

Get Layer 7 Attacks By HTTP Version Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/http_version

Retrieves the distribution of layer 7 attacks by HTTP version.

Get Layer 7 Attacks By Targeted Industry Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/industry

Retrieves the distribution of layer 7 attacks by targeted industry.

Get Layer 7 Attacks By IP Version Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/ip_version

Retrieves the distribution of layer 7 attacks by IP version.

Get Layer 7 Attacks By Managed Rules Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/managed_rules

Retrieves the distribution of layer 7 attacks by managed rules.

Get Layer 7 Attacks By Mitigation Product Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/mitigation_product

Retrieves the distribution of layer 7 attacks by mitigation product.

Get Layer 7 Attacks By Targeted Vertical Summary -> Envelope<{ meta, summary_0 }>

get/radar/attacks/layer7/summary/vertical

Retrieves the distribution of layer 7 attacks by targeted vertical.

Radar Attacks Layer7

Timeseries Groups

radar.attacks.layer7.timeseries_groups

Methods

Get Layer 7 Attacks By HTTP Method Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/http_method

Retrieves the distribution of layer 7 attacks by HTTP method over time.

Get Layer 7 Attacks By HTTP Version Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/http_version

Retrieves the distribution of layer 7 attacks by HTTP version over time.

Get Layer 7 Attacks By Target Industries Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/industry

Retrieves the distribution of layer 7 attacks by targeted industry over time.

Get Layer 7 Attacks By IP Version Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/ip_version

Retrieves the distribution of layer 7 attacks by IP version used over time.

Get Layer 7 Attacks By Managed Rules Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/managed_rules

Retrieves the distribution of layer 7 attacks by managed rules over time.

Get Layer 7 Attacks By Mitigation Product Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/mitigation_product

Retrieves the distribution of layer 7 attacks by mitigation product over time.

Get Layer 7 Attacks By Vertical Time Series -> Envelope<{ meta, serie_0 }>

get/radar/attacks/layer7/timeseries_groups/vertical

Retrieves the distribution of layer 7 attacks by targeted vertical over time.

Radar Attacks Layer7

Top

radar.attacks.layer7.top

Methods

Get Top Layer 7 Attack Pairs Origin And Target Locations -> Envelope<{ meta, top_0 }>

get/radar/attacks/layer7/top/attacks

Retrieves the top attacks from origin to target location. Values are percentages of the total layer 7 attacks (with billing country). The attack magnitude can be defined by the number of mitigated requests or by the number of zones affected. You can optionally limit the number of attacks by origin/target location (useful if all the top attacks are from or to the same location).

Get Top Industries Targeted By Layer 7 Attacks -> Envelope<{ meta, top_0 }>

Deprecated

get/radar/attacks/layer7/top/industry

This endpoint is deprecated. To continue getting this data, switch to the summary by industry endpoint.

Get Top Verticals Targeted By Layer 7 Attacks -> Envelope<{ meta, top_0 }>

Deprecated

get/radar/attacks/layer7/top/vertical

This endpoint is deprecated. To continue getting this data, switch to the summary by vertical endpoint.

Radar Attacks Layer7 Top

Ases

radar.attacks.layer7.top.ases

Methods

Get Top Origin A Ses Of Layer 7 Attacks -> Envelope<{ meta, top_0 }>

get/radar/attacks/layer7/top/ases/origin

Retrieves the top origin autonomous systems of layer 7 attacks. Values are percentages of the total layer 7 attacks, with the origin autonomous systems determined by the client IP address.

Radar Attacks Layer7 Top

Locations

radar.attacks.layer7.top.locations

Methods

Get Top Origin Locations Of Layer 7 Attacks -> Envelope<{ meta, top_0 }>

get/radar/attacks/layer7/top/locations/origin

Retrieves the top origin locations of layer 7 attacks. Values are percentages of the total layer 7 attacks, with the origin location determined by the client IP address.

Get Top Target Locations Of Layer 7 Attacks -> Envelope<{ meta, top_0 }>

get/radar/attacks/layer7/top/locations/target

Retrieves the top target locations of and by layer 7 attacks. Values are a percentage out of the total layer 7 attacks. The target location is determined by the attacked zone's billing country, when available.

Radar

BGP

radar.bgp

Methods

Get BGP Time Series -> Envelope<{ meta, serie_0 }>

get/radar/bgp/timeseries

Retrieves BGP updates over time. When requesting updates for an autonomous system, only BGP updates of type announcement are returned.

Radar BGP

Hijacks

radar.bgp.hijacks

Radar BGP Hijacks

Events

radar.bgp.hijacks.events

Methods

Get BGP Hijack Events -> V4PagePagination<{ asn_info, events, total_monitors }>

get/radar/bgp/hijacks/events

Retrieves the BGP hijack events.

Radar BGP

IPs

radar.bgp.ips

Methods

Get Announced IP Address Space Time Series -> Envelope<{ meta, serie_0 }>

get/radar/bgp/ips/timeseries

Retrieves time series data for the announced IP space count, represented as the number of IPv4 /24s and IPv6 /48s, for a given ASN.

Radar BGP

Leaks

radar.bgp.leaks

Radar BGP Leaks

Events

radar.bgp.leaks.events

Methods

Get BGP Route Leak Events -> V4PagePagination<{ asn_info, events }>

get/radar/bgp/leaks/events

Retrieves the BGP route leak events.

Radar BGP

Routes

radar.bgp.routes

Methods

List A Ses From Global Routing Tables -> Envelope<{ asns, meta }>

get/radar/bgp/routes/ases

Retrieves all ASes in the current global routing tables with routing statistics.

Get Multi Origin As Moas Prefixes -> Envelope<{ meta, moas }>

get/radar/bgp/routes/moas

Retrieves all Multi-Origin AS (MOAS) prefixes in the global routing tables.

Get Prefix To ASN Mapping -> Envelope<{ meta, prefix_origins }>

get/radar/bgp/routes/pfx2as

Retrieves the prefix-to-ASN mapping from global routing tables.

Get Real Time BGP Routes For A Prefix -> Envelope<{ meta, routes }>

get/radar/bgp/routes/realtime

Retrieves real-time BGP routes for a prefix, using public real-time data collectors (RouteViews and RIPE RIS).

Get BGP Routing Table Stats -> Envelope<{ meta, stats }>

get/radar/bgp/routes/stats

Retrieves the BGP routing table stats.

Radar BGP

Top

radar.bgp.top

Methods

Get Top Prefixes By BGP Updates -> Envelope<{ meta, top_0 }>

get/radar/bgp/top/prefixes

Retrieves the top network prefixes by BGP updates.

Radar BGP Top

Ases

radar.bgp.top.ases

Methods

Get Top A Ses By BGP Updates -> Envelope<{ meta, top_0 }>

get/radar/bgp/top/ases

Retrieves the top autonomous systems by BGP updates (announcements only).

Get Top A Ses By Prefix Count -> Envelope<{ asns, meta }>

get/radar/bgp/top/ases/prefixes

Retrieves the full list of autonomous systems on the global routing table ordered by announced prefixes count. The data comes from public BGP MRT data archives and updates every 2 hours.

Radar

Bots

radar.bots

Methods

Get Bot Details -> Envelope<{ bot }>

get/radar/bots/{bot_slug}

Retrieves the requested bot information.

List Bots -> Envelope<{ bots }>

get/radar/bots

Retrieves a list of bots.

Get Bots HTTP Requests Distribution By Dimension -> Envelope<{ meta, summary_0 }>

get/radar/bots/summary/{dimension}

Retrieves an aggregated summary of bots HTTP requests grouped by the specified dimension.

Get Bots HTTP Requests Time Series -> Envelope<{ meta }>

get/radar/bots/timeseries

Retrieves bots HTTP request volume over time.

Get Time Series Distribution Of Bots HTTP Requests By Dimension -> Envelope<{ meta, serie_0 }>

get/radar/bots/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests from bots, grouped by chosen the specified dimension over time.

Radar Bots

Web Crawlers

radar.bots.web_crawlers

Methods

Get Crawler HTTP Request Distribution By Dimension -> Envelope<{ meta, summary_0 }>

get/radar/bots/crawlers/summary/{dimension}

Retrieves an aggregated summary of HTTP requests from crawlers, grouped by the specified dimension.

Get Time Series Of Crawler HTTP Request Distribution By Dimension -> Envelope<{ meta, serie_0 }>

get/radar/bots/crawlers/timeseries_groups/{dimension}

Retrieves the distribution of HTTP requests from crawlers, grouped by chosen the specified dimension over time.

Radar

Ct

radar.ct

Methods

Get Certificate Distribution By Dimension -> Envelope<{ meta, summary_0 }>

get/radar/ct/summary/{dimension}

Retrieves an aggregated summary of certificates grouped by the specified dimension.

Get Certificates Time Series -> Envelope<{ meta }>

get/radar/ct/timeseries

Retrieves certificate volume over time.

Get Time Series Of Certificate Distribution By Dimension -> Envelope<{ meta, serie_0 }>

get/radar/ct/timeseries_groups/{dimension}

Retrieves the distribution of certificates grouped by chosen the specified dimension over time.

Radar Ct

Authorities

radar.ct.authorities

Methods

Get Certificate Authority Details -> Envelope<{ certificateAuthority }>

get/radar/ct/authorities/{ca_slug}

Retrieves the requested CA information.

List Certificate Authorities -> Envelope<{ certificateAuthorities }>

get/radar/ct/authorities

Retrieves a list of certificate authorities.

Radar Ct

Logs

radar.ct.logs

Methods

Get Certificate Log Details -> Envelope<{ certificateLog }>

get/radar/ct/logs/{log_slug}

Retrieves the requested certificate log information.

List Certificate Logs -> Envelope<{ certificateLogs }>

get/radar/ct/logs

Retrieves a list of certificate logs.

Radar

Datasets

radar.datasets

Methods

Get Dataset Download URL -> Envelope<{ dataset }>

post/radar/datasets/download

Retrieves an URL to download a single dataset.

Get Dataset Csv Stream -> string

get/radar/datasets/{alias}

Retrieves the CSV content of a given dataset by alias or ID. When getting the content by alias the latest dataset is returned, optionally filtered by the latest available at a given date.

List Datasets -> Envelope<{ datasets }>

get/radar/datasets

Retrieves a list of datasets.

Radar

DNS

radar.dns

Methods

Get DNS Queries Time Series -> Envelope<{ meta }>

get/radar/dns/timeseries

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

Radar DNS

Summary

radar.dns.summary

Methods

Get DNS Queries By Cache Status Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/cache_hit

Retrieves the distribution of DNS queries by cache status.

Get DNS Queries By DNSSEC Support Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/dnssec

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

Get DNS Queries By DNSSEC Awareness Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/dnssec_aware

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

Get DNS Queries By DNSSEC End To End Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/dnssec_e2e

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

Get DNS Queries By IP Version Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/ip_version

Retrieves the distribution of DNS queries by IP version.

Get DNS Queries By Matching Answer Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/matching_answer

Retrieves the distribution of DNS queries by matching answers.

Get DNS Queries By Protocol Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/protocol

Retrieves the distribution of DNS queries by DNS transport protocol.

Get DNS Queries By Type Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/query_type

Retrieves the distribution of DNS queries by type.

Get DNS Queries By Response Code Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/response_code

Retrieves the distribution of DNS queries by response code.

Get DNS Queries By Response TTL Summary -> Envelope<{ meta, summary_0 }>

get/radar/dns/summary/response_ttl

Retrieves the distribution of DNS queries by minimum response TTL.

Radar DNS

Timeseries Groups

radar.dns.timeseries_groups

Methods

Get DNS Queries By Cache Status Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/cache_hit

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

Security

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

User Details Write User Details Read

query Parameters

aggInterval:

Optional

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

"15m"

"1h"

"1d"

"1w"

asn: Array<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.

continent: Array<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.

dateEnd: Array<string>

Optional

End of the date range (inclusive).

dateRange: Array<string>

Optional

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>

Optional

Start of the date range.

format:

Optional

Format in which results will be returned.

"JSON"

"CSV"

location: Array<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.

name: Array<string>

Optional

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

nodata: boolean

Optional

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

protocol:

Optional

Filters results by DNS transport protocol.

"UDP"

"TCP"

"HTTPS"

"TLS"

queryType:

Optional

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:

Optional

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>

Optional

Filters results by country code top-level domain (ccTLD).

Response fields

result: { meta, serie_0 }

success: boolean

Request example

curl https://api.cloudflare.com/client/v4/radar/dns/timeseries_groups/cache_hit \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY"

200Example

{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "OUTAGE",
            "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 -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/dnssec

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

Get DNS Queries By DNSSEC Awareness Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/dnssec_aware

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

Get DNS Queries By DNSSEC End To End Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/dnssec_e2e

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

Get DNS Queries By IP Version Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/ip_version

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

Get DNS Queries By Matching Answer Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/matching_answer

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

Get DNS Queries By Protocol Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/protocol

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

Get DNS Queries By Type Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/query_type

Retrieves the distribution of DNS queries by type over time.

Get DNS Queries By Response Code Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/response_code

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

Get DNS Queries By Response TTL Time Series -> Envelope<{ meta, serie_0 }>

get/radar/dns/timeseries_groups/response_ttl

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

Radar DNS

Top

radar.dns.top

Methods

Get Top A Ses By DNS Queries -> Envelope<{ meta, top_0 }>

get/radar/dns/top/ases

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

Get Top Locations By DNS Queries -> Envelope<{ meta, top_0 }>

get/radar/dns/top/locations

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

Radar

Email

radar.email

Domain types

RadarEmailSeries = { FAIL, NONE, PASS }

RadarEmailSummary = { FAIL, NONE, PASS }

Radar Email

Routing

radar.email.routing

Radar Email Routing

Summary

radar.email.routing.summary

Methods

Get Email ARC Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/routing/summary/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation.

Get Email DKIM Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/routing/summary/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation.

Get Email DMARC Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/routing/summary/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation.

Get Email Encryption Status Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/routing/summary/encrypted

Retrieves the distribution of emails by encryption status (encrypted vs. not-encrypted).

Get Email IP Version Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/routing/summary/ip_version

Retrieves the distribution of emails by IP version.

Get Email SPF Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/routing/summary/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation.

Radar Email Routing

Timeseries Groups

radar.email.routing.timeseries_groups

Methods

Get Email ARC Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/routing/timeseries_groups/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation over time.

Get Email DKIM Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/routing/timeseries_groups/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation over time.

Get Email DMARC Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/routing/timeseries_groups/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation over time.

Get Email Encryption Status Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/routing/timeseries_groups/encrypted

Retrieves the distribution of emails by encryption status (encrypted vs. not-encrypted) over time.

Get Email IP Version Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/routing/timeseries_groups/ip_version

Retrieves the distribution of emails by IP version over time.

Get Email SPF Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/routing/timeseries_groups/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation over time.

Radar Email

Security

radar.email.security

Radar Email Security

Summary

radar.email.security.summary

Methods

Get Email ARC Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation.

Get Email DKIM Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation.

Get Email DMARC Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation.

Get Email Malicious Classification Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/malicious

Retrieves the distribution of emails by malicious classification.

Get Email Spam Classification Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/spam

Retrieves the proportion of emails by spam classification (spam vs. non-spam).

Get Email SPF Validation Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation.

Get Email Spoof Classification Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/spoof

Retrieves the proportion of emails by spoof classification (spoof vs. non-spoof).

Get Email Threat Category Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/threat_category

Retrieves the distribution of emails by threat categories.

Get Email TLS Version Summary -> Envelope<{ meta, summary_0 }>

get/radar/email/security/summary/tls_version

Retrieves the distribution of emails by TLS version.

Radar Email Security

Timeseries Groups

radar.email.security.timeseries_groups

Methods

Get Email ARC Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/arc

Retrieves the distribution of emails by ARC (Authenticated Received Chain) validation over time.

Get Email DKIM Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/dkim

Retrieves the distribution of emails by DKIM (DomainKeys Identified Mail) validation over time.

Get Email DMARC Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/dmarc

Retrieves the distribution of emails by DMARC (Domain-based Message Authentication, Reporting and Conformance) validation over time.

Get Email Malicious Classification Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/malicious

Retrieves the distribution of emails by malicious classification over time.

Get Email Spam Classification Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/spam

Retrieves the distribution of emails by spam classification (spam vs. non-spam) over time.

Get Email SPF Validation Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/spf

Retrieves the distribution of emails by SPF (Sender Policy Framework) validation over time.

Get Email Spoof Classification Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/spoof

Retrieves the distribution of emails by spoof classification (spoof vs. non-spoof) over time.

Get Email Threat Category Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/threat_category

Retrieves the distribution of emails by threat category over time.

Get Email TLS Version Time Series -> Envelope<{ meta, serie_0 }>

get/radar/email/security/timeseries_groups/tls_version

Retrieves the distribution of emails by TLS version over time.

Radar Email Security

Top

radar.email.security.top

Radar Email Security Top

Tlds

radar.email.security.top.tlds

Methods

Get Top Tl DS By Email Message Volume -> Envelope<{ meta, top_0 }>

get/radar/email/security/top/tlds

Retrieves the top TLDs by number of email messages.

Radar Email Security Top Tlds

Malicious

radar.email.security.top.tlds.malicious

Methods

Get Top Tl DS By Email Malicious Classification -> Envelope<{ meta, top_0 }>

get/radar/email/security/top/tlds/malicious/{malicious}

Retrieves the top TLDs by emails classified as malicious or not.

Radar Email Security Top Tlds

Spam

radar.email.security.top.tlds.spam

Methods

Get Top Tl DS By Email Spam Classification -> Envelope<{ meta, top_0 }>

get/radar/email/security/top/tlds/spam/{spam}

Retrieves the top TLDs by emails classified as spam or not.

Radar Email Security Top Tlds

Spoof

radar.email.security.top.tlds.spoof

Methods

Get Top Tl DS By Email Spoof Classification -> Envelope<{ meta, top_0 }>

get/radar/email/security/top/tlds/spoof/{spoof}

Retrieves the top TLDs by emails classified as spoof or not.

Radar

Entities

radar.entities

Methods

Get IP Address Details -> Envelope<{ ip }>

get/radar/entities/ip

Retrieves IP address information.

Radar Entities

ASNs

radar.entities.asns

Methods

Get As Details By ASN -> Envelope<{ asn }>

get/radar/entities/asns/{asn}

Retrieves the requested autonomous system information. (A confidence level below 5 indicates a low level of confidence in the traffic data - normally this happens because Cloudflare has a small amount of traffic from/to this AS). Population estimates come from APNIC (refer to https://labs.apnic.net/?p=526).

Get As Details By IP Address -> Envelope<{ asn }>

get/radar/entities/asns/ip

Retrieves the requested autonomous system information based on IP address. Population estimates come from APNIC (refer to https://labs.apnic.net/?p=526).

List Autonomous Systems -> Envelope<{ asns }>

get/radar/entities/asns

Retrieves a list of autonomous systems.

Get As Level Relationships By ASN -> Envelope<{ meta, rels }>

get/radar/entities/asns/{asn}/rel

Retrieves AS-level relationship for given networks.

Radar