Docs / List your watchlists

List your watchlists

Last updated 2026-11-13

Your watchlists and your plan limits.

GET/v1/watchlists · API key required

Returns your watchlists with their values and webhook, and the limits of your plan.

Request

curlJavaScriptPython

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

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

import os, requests

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

Response

200 OK

{
  "data": [
    {
      "id": "wl_8c1d2e3f4a5b",
      "name": "My brands",
      "makes": [],
      "models": [],
      "brands": [
        "Graco"
      ],
      "categories": [
        "car_seat"
      ],
      "upcs": [],
      "webhook_id": "wh_3f9a1c07b2d4",
      "created_at": "2026-11-13T12:00:00.000Z"
    }
  ],
  "limits": {
    "watchlists": 1,
    "webhooks": 1,
    "values_per_watchlist": 50,
    "plan": "free"
  }
}

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.