Get HTTP requests by device type time series

GET /radar/http/timeseries_groups/device_type

Copy endpoint

https://api.cloudflare.com/client/v4

Retrieves the distribution of HTTP requests by device type over time.

Parameters

query Query Parameters

Name	Type
`aggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.	"15m" \| "1h" \| "1d" \| "1w"
`name` Array of names used to label the series in the response.	string[]
`dateRange` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters).	string[]
`dateStart` Start of the date range.	string[]
`dateEnd` End of the date range (inclusive).	string[]
`asn` Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with `-` to exclude ASNs from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356.	string[]
`location` Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with `-` to exclude locations from results. For example, `-US,PT` excludes results from the US, but includes results from PT.	string[]
`continent` Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with `-` to exclude continents from results. For example, `-EU,NA` excludes results from EU, but includes results from NA.	string[]
`botClass` Filters results by bot class. Refer to Bot classes.	("LIKELY_AUTOMATED" \| "LIKELY_HUMAN")[]
`httpProtocol` Filters results by HTTP protocol (HTTP vs. HTTPS).	("HTTP" \| "HTTPS")[]
`httpVersion` Filters results by HTTP version.	("HTTPv1" \| "HTTPv2" \| "HTTPv3")[]
`ipVersion` Filters results by IP version (Ipv4 vs. IPv6).	("IPv4" \| "IPv6")[]
`os` Filters results by operating system.	("WINDOWS" \| "MACOSX" \| "IOS" \| "ANDROID" \| "CHROMEOS" \| "LINUX" \| "SMART_TV")[]
`tlsVersion` Filters results by TLS version.	("TLSv1_0" \| "TLSv1_1" \| "TLSv1_2" \| "TLSv1_3" \| "TLSvQUIC")[]
`browserFamily` Filters results by browser family.	("CHROME" \| "EDGE" \| "FIREFOX" \| "SAFARI")[]
`format` Format in which results will be returned.	"JSON" \| "CSV"

Responses

200 application/json

Successful response.

{ result: { meta: {
aggInterval: "FIFTEEN_MINUTES" | "ONE_HOUR" | "ONE_DAY" | "ONE_WEEK" | "ONE_MONTH";
confidenceInfo: { ... };
dateRange: { ... }[];
lastUpdated: string;
normalization: "PERCENTAGE" | "MIN0_MAX" | "MIN_MAX" | "RAW_VALUES" | "PERCENTAGE_CHANGE" | "ROLLING_AVERAGE" | "OVERLAPPED_PERCENTAGE" | "RATIO";
units: { ... }[];
};serie_0: {
desktop: string[];
mobile: string[];
other: string[];
timestamps: string[];
}; };success: boolean; }

Client Errors

400 application/json

Bad request.

{ errors: { message: string; }[];result: {};success: boolean; }