Listing all mitigations of the organisation

Note

The threshold and traffic metrics — configured_bw, configured_pps, configured_bw_percentage, configured_pps_percentage, actual_bw, actual_pps, peak_bw, peak_pps, total_bw, total_pps and (if the dropped data report function is enabled) dropped_bits and dropped_packets — are only returned for automatic mitigations triggered by detection. They are omitted for manual mitigations, which contain no detection data.

Note

SOC accounts must instead address an organisation explicitly through the /organisations/{organisation}/mitigations endpoint.

Sends a GET request to the endpoint /mitigations.

Description

The List-Mitigations request returns a list of all mitigations of the organisation.

Requirements

Values of the request: none

Objects: none

Request

To request a list of all mitigations, no additional information is required in the path of the request.

As a result, the user gets one or more objects MitigationVO with the requested information.

The object provides the following information:

Attributes	Description	Values
`id`	The ID of the mitigation.	`string`
`organisation`	The associated organisation.	`object`
`network`	The mitigated network, or a single IP address in the case of a partial mitigation.	`string`
`mitigation_type`	The type of the applied mitigation.	`ACTION_BLACKHOLE` `ACTION_MITIGATE_ONPREM` `ACTION_MITIGATE_CLOUD`
`mitigation_cause`	How the mitigation was triggered.	`MANUAL_TRIGGER` `AUTO_TRIGGER` `OPS_TRIGGER` `UNKNOWN_TRIGGER`
`start`	When the mitigation started.	`string($date-time)`
`end`	When the mitigation ended; null while it is still running.	`string($date-time)`
`created_at`	The creation date of the entry in ISO 8601 format.	`string($date-time)`
`updated_at`	The date of the last update of the entry in ISO 8601 format.	`string($date-time)`
`actual_bw`	The measured bandwidth at the start of the mitigation.	`number($float)`
`actual_pps`	The measured packet rate at the start of the mitigation.	`number($float)`
`configured_bw`	The bandwidth threshold configured at the start of the mitigation.	`number($float)`
`configured_pps`	The packet rate threshold configured at the start of the mitigation.	`number($float)`
`configured_bw_percentage`	The bandwidth threshold as a percentage of the calculated baseline.	`number`
`configured_pps_percentage`	The packet rate threshold as a percentage of the calculated baseline.	`number`
`peak_bw`	The peak bandwidth observed during the mitigation.	`number($float)`
`peak_pps`	The peak packet rate observed during the mitigation.	`number($float)`
`total_bw`	The total bits processed during the mitigation.	`number($float)`
`total_pps`	The total packets processed during the mitigation.	`number($float)`
`has_report`	Defines whether a detailed mitigation report is available.	`true` `false`
`start_user`	Who started the mitigation.	`object`
`end_user`	Who ended the mitigation; null while it is still running.	`object`

Example

Example response:

{
  "data": [
    {
      "id": "xY9pQ5wR1",
      "organisation": {
        "id": "aB3cD4eF5",
        "name": "ACME GmbH"
      },
      "network": "192.0.2.0/24",
      "mitigation_type": "ACTION_MITIGATE_ONPREM",
      "mitigation_cause": "MANUAL_TRIGGER",
      "start": "2026-01-01T00:00:00+00:00",
      "end": "2026-01-01T00:00:00+00:00",
      "created_at": "2026-01-01T00:00:00+00:00",
      "updated_at": "2026-01-01T00:00:00+00:00",
      "actual_bw": 0,
      "actual_pps": 0,
      "configured_bw": 0,
      "configured_pps": 0,
      "configured_bw_percentage": 0,
      "configured_pps_percentage": 0,
      "peak_bw": 0,
      "peak_pps": 0,
      "total_bw": 0,
      "total_pps": 0,
      "has_report": true,
      "start_user": {
        "id": "pQ7rS8tU9",
        "name": "Max Mustermann"
      },
      "end_user": {
        "id": "pQ7rS8tU9",
        "name": "Max Mustermann"
      }
    }
  ],
  "links": {
    "first": "https://datahub-api.com/api/networks?page=1",
    "last": "https://datahub-api.com/api/networks?page=5",
    "prev": null,
    "next": "https://datahub-api.com/api/networks?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "links": [
      {
        "url": "https://datahub-api.com/api/networks?page=2",
        "label": "Next »",
        "active": false
      }
    ],
    "path": "https://datahub-api.com/api/networks",
    "per_page": 15,
    "to": 15,
    "total": 64
  }
}

Responses

The following responses are available:

STATUS CODE	DESCRIPTION
200	The request has succeeded.
401	The request has not succeeded because the user authentication was incorrect.
403	The request has not succeeded because the user does not have the right permissions.