Docs / List your webhooks

List your webhooks

Last updated 2026-11-13

Your webhooks and their status.

GET/v1/webhooks · API key required

Returns your webhooks with their status (active or disabled) and consecutive failures. Secrets are never shown again.

Request

curlJavaScriptPython

curl https://recalldb.app/v1/webhooks \
  -H "Authorization: Bearer $RECALLDB_KEY"

const res = await fetch('https://recalldb.app/v1/webhooks', {
  headers: { Authorization: `Bearer ${process.env.RECALLDB_KEY}` },
})
console.log(await res.json())

import os, requests

r = requests.get("https://recalldb.app/v1/webhooks", headers={"Authorization": f"Bearer {os.environ['RECALLDB_KEY']}"})
r.raise_for_status()
body = r.json()
print(body)

Response

200 OK

{
  "data": [
    {
      "id": "wh_3f9a1c07b2d4",
      "url": "https://example.com/recalls",
      "status": "active",
      "consecutive_failures": 0,
      "disabled_reason": null,
      "created_at": "2026-11-13T12:00:00.000Z"
    }
  ]
}

Every response includes source (agency, official ID, official URL, last updated) and attribution. Attribution rules.

Notes

Counts as one request.

Errors: error codes. Limits: rate limits.