DeluxHostAPI Reference
Firewall

Get DDoS attack details

GET
/v1/firewall/attacks/{attackId}

ip is required and is what proves the record is yours: attack ids are a global sequence, so an id alone identifies nothing you are entitled to. A mismatch is a 404, like every other id that is not yours.

Authorization

apiToken firewall:read
headerAuthorizationBearer <token>

A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.

Scope: firewall:read

Path Parameters

attackId*integer

id from GET /v1/firewall/attacks.

Query Parameters

ip*string

One of your protected addresses, from GET /v1/firewall/ips. Any other address is a 403.

Response Body

The attack and its per-port breakdown.

application/json
  1. response
attack*
ports*array<>
curl -X GET 'https://api.deluxhost.net/v1/firewall/attacks/0?ip=string' \  -H "Authorization: Bearer $DELUXHOST_TOKEN"
Example Response
{  "attack": {    "id": 0,    "ip": "string",    "startedAt": "string",    "endedAt": "string",    "peak": "string",    "peakGbps": 0,    "flags": [      "string"    ]  },  "ports": [    {      "port": 0,      "protocol": "string",      "packetsPeak": 0    }  ]}