CrowdSec — API

Swagger CrowdSecv1.0.0 Read the vendor's spec ↗

23 endpoints
1 version archived since Jul 20, 2026
Last checked Nov 2, 2026

CrowdSec local API

first call

$ curl "https://127.0.0.1/v1/alerts" \
  -H "Authorization: Bearer: $API_KEY"

Set $API_KEY first, then paste.

Base URL: https://127.0.0.1/v1
Authenticate: API key in the Authorization: Bearer header

1 other scheme

API key in the X-Api-Key header
Shape: GET7
POST5
DELETE5
HEAD6

What it covers

Watchers 18 Operations about watchers : cscli & crowdsec
Remediation Component 5 Operations about decisions : bans, captcha, rate-limit etc.

Open an endpoint for a runnable command, its inputs and what it returns.

Watchers 18

DELETE /alerts deleteAlerts

Loading…
DELETE /alerts/{alert_id} DeleteAlert

Loading…
DELETE /decisions deleteDecisions

Loading…
DELETE /decisions/{decision_id} DeleteDecision

Loading…
DELETE /watchers/self DeleteWatcher

Loading…
GET /alerts searchAlerts

Loading…
GET /alerts/{alert_id} GetAlertByID

Loading…
GET /allowlists getAllowlists

Loading…
GET /allowlists/check/{ip_or_range} checkAllowlist

Loading…
GET /allowlists/{allowlist_name} getAllowlist

Loading…
HEAD /alerts searchAlerts

Loading…
HEAD /alerts/{alert_id} GetAlertByID

Loading…
HEAD /allowlists/check/{ip_or_range} checkAllowlist

Loading…
HEAD /allowlists/{allowlist_name} getAllowlist

Loading…
POST /alerts pushAlerts

Loading…
POST /allowlists/check postCheckAllowlist

Loading…
POST /watchers RegisterWatcher

Loading…
POST /watchers/login AuthenticateWatcher

Loading…

Remediation Component 5

GET /decisions getDecisions

Loading…
GET /decisions/stream getDecisionsStream

Loading…
HEAD /decisions GetDecisions

Loading…
HEAD /decisions/stream GetDecisionsStream

Loading…
POST /usage-metrics Send usage metrics

Loading…