API keys

The corpus API serves the same data this dashboard shows — bills, local agenda items, signals, jurisdictions, forecasts — to your own programs instead of to a screen. A key identifies you and counts what you use. Keys are personal: anything you build with one acts as you.

Using it

Send the key in an Authorization header. Every reply carries your remaining allowance in X-RateLimit-Remaining; spend the month and the API answers 429 until it resets on the first of the next month, UTC.

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://sentinel-production-ff0d.up.railway.app/api/v1/bills?limit=5"

Coverage counts, the agenda watch list and the full scoring methodology are open and need no key at all — /api/v1/methodology, /api/v1/agenda/coverage and /api/v1/queue.