API-Dokumentation

Basisadresse: https://www.bastionblock.eu/v2. Du sendest deinen Schlüssel im Header mit Key.

Die API liefert nur die Sperrungen, die ich selbst festgestellt habe. Listen anderer Parteien nutze ich intern, gebe sie aber nicht weiter.

GET /v2/check

curl -H "Key: IHR_SCHLÜSSEL" "https://www.bastionblock.eu/v2/check?ip=1.2.3.4"

{"data": {"ipAddress": "1.2.3.4", "ipVersion": 4, "isListed": true,
  "abuseConfidenceScore": 80, "totalReports": 112,
  "firstSeenAt": "2026-10-13T06:25:05+00:00", "lastSeenAt": "2026-10-20T15:17:39+00:00",
  "entries": [{"network": "1.2.3.4/32", "category": "web-attack", "score": 80,
               "hits": 112, "expires": "2027-10-20T15:17:39+00:00", "active": true}]}}

Ohne Schlüssel funktioniert dies ebenfalls, jedoch mit einer niedrigen Begrenzung (20 Fragen pro Minute).

GET /v2/blacklist

curl -H "Key: …" "https://www.bastionblock.eu/v2/blacklist?confidenceMinimum=90"
curl -H "Key: …" "https://www.bastionblock.eu/v2/blacklist?confidenceMinimum=90&plaintext=1"

Parameter
`confidenceMinimum`	0–100, Standard 75
`limit`	maximale Anzahl Zeilen (10000, max 100000)
`plaintext=1`	eine Adresse pro Zeile

Kategorien

web-attack Angriffe auf Webseiten · mail-bruteforce Passwörter für E-Mail-Raten · manual manuell von mir hinzugefügt

Grenzen und Fehlercodes

Standardmäßig 60 Anfragen pro Minute und 5000 pro Tag pro Schlüssel. 401 Schlüssel ungültig oder fehlt · 422 ungültige IP-Adresse · 429 Grenzwert erreicht; der Header Retry-After gibt an, wann wieder Kapazität verfügbar ist