Get the top attacks from origin to target location. Values are a percentage out of the total layer 7 attacks (with billing country). The attack magnitude can be defined by the number of mitigated requests or by the number of zones affected. You can optionally limit the number of attacks per origin/target location (useful if all the top attacks are from or to the same location).
/radar/attacks/layer7/top/attacks
get
Radar Attacks
radar-get-attacks-layer7-top-attacks
{
"business": true,
"enterprise": true,
"free": true,
"pro": true
}{
"enum": [
"com.cloudflare.api.user.read"
]
}[
{
"in": "query",
"name": "limit",
"schema": {
"description": "Limit the number of objects in the response.",
"example": 5,
"type": "integer"
}
},
{
"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"
}
},
{
"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).",
"items": {
"enum": [
"1d",
"2d",
"7d",
"14d",
"28d",
"12w",
"24w",
"52w",
"1dControl",
"2dControl",
"7dControl",
"14dControl",
"28dControl",
"12wControl",
"24wControl"
],
"type": "string"
},
"type": "array"
}
},
{
"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"
}
},
{
"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"
}
},
{
"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"
}
},
{
"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"
}
},
{
"in": "query",
"name": "limitDirection",
"schema": {
"default": "ORIGIN",
"description": "Array of attack origin/target location attack limits. Together with `limitPerLocation`, limits how many objects will be fetched per origin/target location.",
"enum": [
"ORIGIN",
"TARGET"
],
"example": "ORIGIN",
"type": "string"
}
},
{
"in": "query",
"name": "limitPerLocation",
"schema": {
"description": "Limit the number of attacks per origin/target (refer to `limitDirection` parameter) location.",
"example": 10,
"type": "integer"
}
},
{
"in": "query",
"name": "magnitude",
"schema": {
"description": "Attack magnitude can be defined by total requests mitigated or by total zones attacked.",
"enum": [
"AFFECTED_ZONES",
"MITIGATED_REQUESTS"
],
"example": "MITIGATED_REQUESTS",
"type": "string"
}
},
{
"in": "query",
"name": "format",
"schema": {
"description": "Format results are returned in.",
"enum": [
"JSON",
"CSV"
],
"example": "json",
"type": "string"
}
}
]null{
"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": {
"type": "object"
},
"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": {
"originCountryAlpha2": {
"example": "US",
"type": "string"
},
"originCountryName": {
"example": "United States",
"type": "string"
},
"targetCountryAlpha2": {
"example": "FR",
"type": "string"
},
"targetCountryName": {
"example": "France",
"type": "string"
},
"value": {
"example": "4.323214",
"type": "string"
}
},
"required": [
"originCountryAlpha2",
"originCountryName",
"targetCountryAlpha2",
"targetCountryName",
"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"
}
}[
{
"api_email": [],
"api_key": []
}
]