openapi: 3.0.0
info:
version: 2015-07-09
x-release: v4
title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Radar Http API
description:
Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.
x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: apigateway x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/apigateway-2015-07-09.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://apigateway.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Amazon API Gateway multi-region endpoint - url: https://apigateway.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Amazon API Gateway multi-region endpoint - url: http://apigateway.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia) - url: https://apigateway.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: Radar Http paths: /radar/http/summary/bot_class: get: description: Percentage distribution of bot-generated traffic to genuine human traffic, as classified by Cloudflare. Visit https://developers.cloudflare.com/radar/concepts/bot-classes/ for more information. operationId: radar-get-http-summary-by-bot-class parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: bot: example: '35' type: string human: example: '65' type: string required: - human - bot type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Bot Class Summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/device_type: get: description: Percentage of Internet traffic generated by mobile, desktop, and other types of devices, over a given time period. operationId: radar-get-http-summary-by-device-type parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: desktop: example: '65' type: string mobile: example: '30' type: string other: example: '5' type: string required: - desktop - mobile - other type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Device Type Summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/http_protocol: get: description: Percentage distribution of traffic per HTTP protocol over a given time period. operationId: radar-get-http-summary-by-http-protocol parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: http: example: '99' type: string https: example: '1' type: string required: - http - https type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP protocols summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/http_version: get: description: Percentage distribution of traffic per HTTP protocol version over a given time period. operationId: radar-get-http-summary-by-http-version parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: HTTP/1.x: example: '1' type: string HTTP/2: example: '39' type: string HTTP/3: example: '60' type: string required: - HTTP/1.x - HTTP/2 - HTTP/3 type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP Versions Summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/ip_version: get: description: Percentage distribution of Internet traffic based on IP protocol versions, such as IPv4 and IPv6, over a given time period. operationId: radar-get-http-summary-by-ip-version parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: IPv4: example: '65' type: string IPv6: example: '35' type: string required: - IPv4 - IPv6 type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get IP Version Summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/os: get: description: Percentage distribution of Internet traffic generated by different operating systems like Windows, macOS, Android, iOS, and others, over a given time period. operationId: radar-get-http-summary-by-operating-system parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: ANDROID: example: '65' type: string IOS: example: '35' type: string required: - ANDROID - IOS type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Operating Systems Summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/post_quantum: get: description: Percentage distribution of traffic per Post Quantum support over a given time period. operationId: radar-get-http-summary-by-post-quantum parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: NOT_SUPPORTED: example: '16' type: string SUPPORTED: example: '84' type: string required: - SUPPORTED - NOT_SUPPORTED type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP Post Quantum summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/summary/tls_version: get: description: Percentage distribution of traffic per TLS protocol version, over a given time period. operationId: radar-get-http-summary-by-tls-version parameters: - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string normalization: example: PERCENTAGE type: string required: - dateRange - normalization - lastUpdated type: object summary_0: properties: TLS 1.0: example: '0.5' type: string TLS 1.1: example: '0.5' type: string TLS 1.2: example: '60' type: string TLS 1.3: example: '10' type: string TLS QUIC: example: '29' type: string required: - TLS 1.0 - TLS 1.1 - TLS 1.2 - TLS 1.3 - TLS QUIC type: object required: - meta - summary_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get TLS Versions Summary tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries: get: description: Get HTTP requests over time. operationId: radar-get-http-timeseries parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Normalization method applied. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/). in: query name: normalization schema: description: Normalization method applied. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/). enum: - PERCENTAGE_CHANGE - MIN0_MAX example: MIN0_MAX type: string - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: aggInterval: example: 1h type: string confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: format: date-time type: string required: - dateRange - aggInterval - lastUpdated type: object serie_0: properties: timestamps: items: format: date-time type: string type: array values: items: example: 0.56 type: string type: array required: - timestamps - values type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP requests Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/bot_class: get: description: Get a time series of the percentage distribution of traffic classified as automated or human. Visit https://developers.cloudflare.com/radar/concepts/bot-classes/ for more information. operationId: radar-get-http-timeseries-group-by-bot-class parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: bot: items: type: string type: array human: items: type: string type: array timestamps: items: type: string type: array required: - timestamps - human - bot type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Bot Classes Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/browser: get: description: Get a time series of the percentage distribution of traffic of the top user agents. operationId: radar-get-http-timeseries-group-by-browsers parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Limit the number of objects (eg browsers, verticals, etc) to the top items over the time range. in: query name: limitPerGroup schema: description: Limit the number of objects (eg browsers, verticals, etc) to the top items over the time range. example: 4 type: integer - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: additionalProperties: items: type: string type: array example: Chrome: - '50.168733' timestamps: - '2023-08-08T10:15:00Z' properties: timestamps: items: type: string type: array required: - timestamps type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get User Agents Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/browser_family: get: description: Get a time series of the percentage distribution of traffic of the top user agents aggregated in families. operationId: radar-get-http-timeseries-group-by-browser-families parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: additionalProperties: items: type: string type: array example: Chrome: - '50.168733' timestamps: - '2023-08-08T10:15:00Z' properties: timestamps: items: type: string type: array required: - timestamps type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get User Agent Families Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/device_type: get: description: Get a time series of the percentage distribution of traffic per device type. operationId: radar-get-http-timeseries-group-by-device-type parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: desktop: items: type: string type: array mobile: items: type: string type: array other: items: type: string type: array timestamps: items: type: string type: array required: - timestamps - desktop - mobile - other type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Device Types Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/http_protocol: get: description: Get a time series of the percentage distribution of traffic per HTTP protocol. operationId: radar-get-http-timeseries-group-by-http-protocol parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: http: items: type: string type: array https: items: type: string type: array timestamps: items: type: string type: array required: - timestamps - http - https type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP protocols Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/http_version: get: description: Get a time series of the percentage distribution of traffic per HTTP protocol version. operationId: radar-get-http-timeseries-group-by-http-version parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: HTTP/1.x: items: type: string type: array HTTP/2: items: type: string type: array HTTP/3: items: type: string type: array timestamps: items: type: string type: array required: - timestamps - HTTP/1.x - HTTP/2 - HTTP/3 type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP Versions Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/ip_version: get: description: Get a time series of the percentage distribution of traffic per IP protocol version. operationId: radar-get-http-timeseries-group-by-ip-version parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: IPv4: items: type: string type: array IPv6: items: type: string type: array timestamps: items: type: string type: array required: - timestamps - IPv4 - IPv6 type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get IP Versions Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/os: get: description: Get a time series of the percentage distribution of traffic of the top operating systems. operationId: radar-get-http-timeseries-group-by-operating-system parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: additionalProperties: items: type: string type: array example: ANDROID: - '97.28898' timestamps: - '2023-08-08T10:15:00Z' properties: timestamps: items: type: string type: array required: - timestamps type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Operating Systems Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/post_quantum: get: description: Get a time series of the percentage distribution of traffic per Post Quantum suport. operationId: radar-get-http-timeseries-group-by-post-quantum parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: NOT_SUPPORTED: items: example: '16' type: string type: array SUPPORTED: items: example: '84' type: string type: array timestamps: items: type: string type: array required: - timestamps - SUPPORTED - NOT_SUPPORTED type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get HTTP Post Quantum Support Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/timeseries_groups/tls_version: get: description: Get a time series of the percentage distribution of traffic per TLS protocol version. operationId: radar-get-http-timeseries-group-by-tls-version parameters: - description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). in: query name: aggInterval schema: description: Aggregation interval results should be returned in (for example, in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). enum: - 15m - 1h - 1d - 1w example: 1h type: string - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: type: object serie_0: properties: TLS 1.0: items: type: string type: array TLS 1.1: items: type: string type: array TLS 1.2: items: type: string type: array TLS 1.3: items: type: string type: array TLS QUIC: items: type: string type: array timestamps: items: type: string type: array required: - timestamps - TLS 1.0 - TLS 1.1 - TLS 1.2 - TLS 1.3 - TLS QUIC type: object required: - meta - serie_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '400': content: application/json: schema: properties: errors: items: properties: message: type: string required: - message type: object type: array result: type: object success: example: false type: boolean required: - result - success - errors type: object description: Bad Request security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get TLS Versions Time Series tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases: get: description: Get the top autonomous systems by HTTP traffic. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-http-requests parameters: - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By HTTP Requests tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/bot_class/{bot_class}: get: description: Get the top autonomous systems (AS), by HTTP traffic, of the requested bot class. These two categories use Cloudflare's bot score - refer to [Bot Scores](https://developers.cloudflare.com/bots/concepts/bot-score) for more information. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-bot-class parameters: - description: Bot class. in: path name: bot_class required: true schema: description: Bot class. enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By Bot Class tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/browser_family/{browser_family}: get: description: Get the top autonomous systems (AS), by HTTP traffic, of the requested browser family. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-browser-family parameters: - description: Browser family. in: path name: browser_family required: true schema: description: Browser family. enum: - CHROME - EDGE - FIREFOX - SAFARI type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By Browser Family tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/device_type/{device_type}: get: description: Get the top autonomous systems (AS), by HTTP traffic, of the requested device type. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-device-type parameters: - description: Device type. in: path name: device_type required: true schema: description: Device type. enum: - DESKTOP - MOBILE - OTHER type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By Device Type tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/http_protocol/{http_protocol}: get: description: Get the top autonomous systems (AS), by HTTP traffic, of the requested HTTP protocol. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-http-protocol parameters: - description: HTTP Protocol. in: path name: http_protocol required: true schema: description: HTTP Protocol. enum: - HTTP - HTTPS type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By HTTP Protocol tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/http_version/{http_version}: get: description: Get the top autonomous systems (AS), by HTTP traffic, of the requested HTTP protocol version. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-http-version parameters: - description: HTTP version. in: path name: http_version required: true schema: description: HTTP version. enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By HTTP Version tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/ip_version/{ip_version}: get: description: Get the top autonomous systems, by HTTP traffic, of the requested IP protocol version. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-ip-version parameters: - description: IP version. in: path name: ip_version required: true schema: description: IP version. enum: - IPv4 - IPv6 type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By IP Version tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/os/{os}: get: description: Get the top autonomous systems, by HTTP traffic, of the requested operating systems. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-operating-system parameters: - description: Operating system. in: path name: os required: true schema: description: Operating system. enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By Operating System tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/ases/tls_version/{tls_version}: get: description: Get the top autonomous systems (AS), by HTTP traffic, of the requested TLS protocol version. Values are a percentage out of the total traffic. operationId: radar-get-http-top-ases-by-tls-version parameters: - description: TLS version. in: path name: tls_version required: true schema: description: TLS version. enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientASN: example: 3243 type: integer clientASName: example: MEO type: string value: example: '3' type: string required: - clientASN - clientASName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Autonomous Systems By TLS Version tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/browser: get: description: Get the top user agents by HTTP traffic. Values are a percentage out of the total traffic. operationId: radar-get-http-top-browsers parameters: - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: name: example: chrome type: string value: type: string required: - name - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top User Agents By HTTP requests tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/browser_family: get: description: Get the top user agents aggregated in families by HTTP traffic. Values are a percentage out of the total traffic. operationId: radar-get-http-top-browser-families parameters: - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: name: example: chrome type: string value: type: string required: - name - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top User Agents Families by HTTP requests tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations: get: description: Get the top locations by HTTP traffic. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-http-requests parameters: - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By HTTP requests tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/bot_class/{bot_class}: get: description: Get the top locations, by HTTP traffic, of the requested bot class. These two categories use Cloudflare's bot score - refer to [Bot scores])https://developers.cloudflare.com/bots/concepts/bot-score). Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-bot-class parameters: - description: Bot class. in: path name: bot_class required: true schema: description: Bot class. enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By Bot Class tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/browser_family/{browser_family}: get: description: Get the top locations, by HTTP traffic, of the requested browser family. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-browser-family parameters: - description: Browser family. in: path name: browser_family required: true schema: description: Browser family. enum: - CHROME - EDGE - FIREFOX - SAFARI type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By Browser Family tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/device_type/{device_type}: get: description: Get the top locations, by HTTP traffic, of the requested device type. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-device-type parameters: - description: Device type. in: path name: device_type required: true schema: description: Device type. enum: - DESKTOP - MOBILE - OTHER type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By Device Type tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/http_protocol/{http_protocol}: get: description: Get the top locations, by HTTP traffic, of the requested HTTP protocol. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-http-protocol parameters: - description: HTTP Protocol. in: path name: http_protocol required: true schema: description: HTTP Protocol. enum: - HTTP - HTTPS type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By HTTP Protocol tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/http_version/{http_version}: get: description: Get the top locations, by HTTP traffic, of the requested HTTP protocol. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-http-version parameters: - description: HTTP version. in: path name: http_version required: true schema: description: HTTP version. enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By HTTP Version tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/ip_version/{ip_version}: get: description: Get the top locations, by HTTP traffic, of the requested IP protocol version. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-ip-version parameters: - description: IP version. in: path name: ip_version required: true schema: description: IP version. enum: - IPv4 - IPv6 type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By IP Version tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/os/{os}: get: description: Get the top locations, by HTTP traffic, of the requested operating systems. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-operating-system parameters: - description: Operating system. in: path name: os required: true schema: description: Operating system. enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for tls version. in: query name: tlsVersion schema: description: Filter for tls version. example: TLSv1_2 items: enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By Operating System tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true /radar/http/top/locations/tls_version/{tls_version}: get: description: Get the top locations, by HTTP traffic, of the requested TLS protocol version. Values are a percentage out of the total traffic. operationId: radar-get-http-top-locations-by-tls-version parameters: - description: TLS version. in: path name: tls_version required: true schema: description: TLS version. enum: - TLSv1_0 - TLSv1_1 - TLSv1_2 - TLSv1_3 - TLSvQUIC type: string - description: Limit the number of objects in the response. in: query name: limit schema: description: Limit the number of objects in the response. example: 5 type: integer - description: Array of names that will be used to name the series in responses. in: query name: name schema: description: Array of names that will be used to name the series in responses. example: main_series items: type: string type: array - description: 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). in: query name: dateRange schema: description: 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). example: 7d items: example: 7d pattern: ^((([1-9]|[1-9][0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-4])[d](control)?)|(([1-9]|[1-4][0-9]|5[0-2])[w](control)?))$ type: string type: array - description: Array of datetimes to filter the start of a series. in: query name: dateStart schema: description: Array of datetimes to filter the start of a series. example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: End of the date range (inclusive). in: query name: dateEnd schema: description: End of the date range (inclusive). example: '2023-09-01T11:41:33.782Z' items: format: date-time type: string type: array - description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. in: query name: asn schema: description: Array of comma separated list of ASNs, start with `-` to exclude from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. example: '15169' items: type: string type: array - description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. in: query name: location schema: description: Array of comma separated list of locations (alpha-2 country codes). Start with `-` to exclude from results. For example, `-US,PT` excludes results from the US, but includes results from PT. example: US,CA items: type: string type: array - description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. in: query name: continent schema: description: Array of comma separated list of continents (alpha-2 continent codes). Start with `-` to exclude from results. For example, `-EU,NA` excludes results from Europe, but includes results from North America. example: EU,NA items: type: string type: array - description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). in: query name: botClass schema: description: Filter for bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). example: LIKELY_AUTOMATED items: enum: - LIKELY_AUTOMATED - LIKELY_HUMAN type: string type: array - description: Filter for device type. in: query name: deviceType schema: description: Filter for device type. example: DESKTOP items: enum: - DESKTOP - MOBILE - OTHER type: string type: array - description: Filter for http protocol. in: query name: httpProtocol schema: description: Filter for http protocol. example: HTTPS items: enum: - HTTP - HTTPS type: string type: array - description: Filter for http version. in: query name: httpVersion schema: description: Filter for http version. example: HTTPv1 items: enum: - HTTPv1 - HTTPv2 - HTTPv3 type: string type: array - description: Filter for ip version. in: query name: ipVersion schema: description: Filter for ip version. example: IPv4 items: enum: - IPv4 - IPv6 type: string type: array - description: Filter for os name. in: query name: os schema: description: Filter for os name. example: WINDOWS items: enum: - WINDOWS - MACOSX - IOS - ANDROID - CHROMEOS - LINUX - SMART_TV type: string type: array - description: Filter for browser family. in: query name: browserFamily schema: description: Filter for browser family. example: CHROME items: enum: - CHROME - EDGE - FIREFOX - SAFARI type: string type: array - description: Format results are returned in. in: query name: format schema: description: Format results are returned in. enum: - JSON - CSV example: json type: string responses: '200': content: application/json: schema: properties: result: properties: meta: properties: confidenceInfo: properties: annotations: items: properties: dataSource: example: ALL type: string description: example: Cable cut in Tonga type: string endTime: format: date-time type: string eventType: example: OUTAGE type: string isInstantaneous: example: true type: boolean linkedUrl: type: string startTime: format: date-time type: string required: - dataSource - eventType - description - isInstantaneous type: object type: array level: type: integer type: object dateRange: items: properties: endTime: description: Adjusted end of date range. example: '2022-09-17T10:22:57.555Z' format: date-time type: string startTime: description: Adjusted start of date range. example: '2022-09-16T10:22:57.555Z' format: date-time type: string required: - startTime - endTime type: object type: array lastUpdated: example: '2023-07-26T08:59:57Z' type: string required: - dateRange - lastUpdated type: object top_0: items: properties: clientCountryAlpha2: example: US type: string clientCountryName: example: United States type: string value: example: '65' type: string required: - clientCountryAlpha2 - clientCountryName - value type: object type: array required: - meta - top_0 type: object success: example: true type: boolean required: - result - success type: object description: Successful Response '404': content: application/json: schema: properties: error: example: Not Found type: string required: - error type: object description: Not found security: - api_email: [] api_key: [] api_token: [] summary: APIs.io Engineering Platform Get Top Locations By TLS Version tags: - Radar Http x-cfPermissionsRequired: enum: - com.cloudflare.api.user.read x-cfPlanAvailability: business: true enterprise: true free: true pro: true components: securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/apigateway/ x-hasEquivalentPaths: true