DeluxHostAPI Reference
Firewall

List DDoS attacks

GET
/v1/firewall/attacks

Mitigated attacks against one address, newest first. endedAt is null while one is still in progress — that, not a separate endpoint, is how you tell you are under attack now.

Page-numbered rather than cursor-paginated like the invoice list: the panel offers page and size, and a cursor on top of that would promise a stability it does not give.

Authorization

apiToken firewall:read
headerAuthorizationBearer <token>

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

Scope: firewall:read

Query Parameters

ip*string

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

page?integer
Range1 <= value
Default1
limit?integer
Range1 <= value <= 100
Default20

Response Body

One page of attacks, and how many there are in total.

application/json
  1. response
items*array<>
total*integer

Attacks on record for this address.

curl -X GET 'https://api.deluxhost.net/v1/firewall/attacks?ip=string' \  -H "Authorization: Bearer $DELUXHOST_TOKEN"
Example Response
{  "items": [    {      "id": 0,      "ip": "string",      "startedAt": "string",      "endedAt": "string",      "peak": "string",      "peakGbps": 0,      "flags": [        "string"      ]    }  ],  "total": 0}