GET /radar/attacks/layer7/top/attacks

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

Servers

Query parameters

Name Type Required Description
limitDirection String No

Specifies whether the limitPerLocation applies to the source or target location.

Possible values:

  • "TARGET"
  • "ORIGIN"

Default value: "ORIGIN"

mitigationProduct[] Array No

Filters the results by layer 7 mitigation product.

dateEnd[] Array No

End of the date range (inclusive).

limitPerLocation Integer No

Limits the number of attacks per origin/target (refer to limitDirection parameter) location.

location[] Array No

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.

dateStart[] Array No

Start of the date range.

dateRange[] Array No

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).

magnitude String No

Deprecated parameter. Future support includes only attack magnitude defined by total mitigated requests (MITIGATED_REQUESTS).

Possible values:

  • "AFFECTED_ZONES"
  • "MITIGATED_REQUESTS"
asn[] Array No

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.

limit Integer No

Limits the number of objects returned in the response.

name[] Array No

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

format String No

Format in which results will be returned.

Possible values:

  • "CSV"
  • "JSON"
normalization String No

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

Possible values:

  • "PERCENTAGE"
  • "MIN_MAX"

Default value: "PERCENTAGE"

continent[] Array No

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.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.