Quickstart

From zero to your first webhook in under 60 seconds.

1. Set your API key

export AIACTRADAR_API_KEY=aiactr_…

2. Sanity-check the pipeline

curl https://api.aiactradar.com/v1/health | jq

Expected: { "status": "ok", "events_total": <integer>, "sources": […] }

3. Create a webhook subscription

curl https://api.aiactradar.com/v1/subscriptions \
  -H "Authorization: Bearer $AIACTRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://your-app.example/webhooks/aiactradar",
    "topics": ["gpai", "high-risk", "transparency"],
    "severity_min": "medium",
    "language": "en"
  }'

The response includes webhook_secret — shown ONCE. Store it now. You will need it to verify the HMAC-SHA256 signature on every incoming payload.

4. Verify your endpoint with a synthetic test event

curl -X POST https://api.aiactradar.com/v1/subscriptions/$SUB_ID/test \
  -H "Authorization: Bearer $AIACTRADAR_API_KEY"

This fires a severity:"info" event with source:"test" at your URL so you can check signature verification + parsing end-to-end.

5. Implement the receiver

Drop-in samples:

6. Watch deliveries

curl https://api.aiactradar.com/v1/deliveries?status=delivered&limit=20 \
  -H "Authorization: Bearer $AIACTRADAR_API_KEY" | jq

What's next