The Iowa Funnel API

How it works

• A free key. Send it in the X-Api-Key header (or as ?api_key=, which is easier to try but ends up in logs and browser history).
• 1,000 requests an hour per key. Each response says how many are left (X-RateLimit-Remaining) and when the count starts over (X-RateLimit-Reset). Past the limit you get status 429.
• Read-only, GET only. Any website may call it from the browser (CORS is open). Responses are cached for five minutes, so data can be a few minutes behind the site.
• Every response has data, and meta with the source, as_of (when that source last loaded), and for lists page, per_page (up to 500), total and the next page’s address.
• What’s left out: anything about the people who use Iowa Funnel (accounts, follows, saved addresses, emails), admin data, individual donors, payments to individuals, school administrators’ contacts and private court cases.
• Terms: free; please credit “Iowa Funnel” and link to the page; no guarantee it’s complete, current or always up. See the terms.

Try it

curl -H "X-Api-Key: YOUR_KEY" "https://iowafunnel.com/api/v1/bills?ga=91&per_page=5"

const res = await fetch("https://iowafunnel.com/api/v1/bills?ga=91&per_page=5", { headers: { "X-Api-Key": "YOUR_KEY" } });
const { data, meta } = await res.json();
console.log(meta.total, data[0].number, data[0].title);

{
  "data": [{ "ga": 91, "number": "HF 2", "title": "...", "status": "...", "page": "https://iowafunnel.com/bills/91/HF2" }],
  "meta": { "source": { "name": "Iowa Legislature", "url": "https://www.legis.iowa.gov" },
            "as_of": "2026-11-13T19:03:41Z", "page": 1, "per_page": 5, "total": 2210,
            "next": "/api/v1/bills?ga=91&page=2&per_page=5" },
  "attribution": "Iowa Funnel (iowafunnel.com), from public records"
}

Errors

Errors come back as { "error": { "status": 401, "message": "..." } }: 401 for a missing or revoked key, 404 when nothing’s at that address, 429 past the hourly limit, and 503 when the database is busy (try again shortly).