Reference

API reference

Every endpoint below is generated from the same catalog the API serves — this page can’t drift from what’s actually deployed. Machine-readable versions: /api/openapi and /llms.txt.

Base URL

https://www.bill100.com/api/v1

Auth

Optional for reads (anonymous = throttled: 6/min, 40/day). Send `Authorization: Bearer bill100_live_…` (or `x-api-key`) for plan quotas. AI impact analysis requires a Pro/Scale key.

Metering

Reads are metered per API call (generous free tier). Tailored AI impact analyses are the paid metered unit.

Bill id format

Every bill id is <congress>-<type>-<number>, e.g. 119-hr-1234. Type codes:

hr = H.R.s = S.hres = H.Res.sres = S.Res.hjres = H.J.Res.sjres = S.J.Res.hconres = H.Con.Res.sconres = S.Con.Res.

Response envelope

Every successful response includes a request_id for tracing and a disclaimer. Free/anonymous responses also carry an attribution field. Every bill carries its own sources block linking Congress.gov and GovTrack.

{
  "bill": {
    "id": "119-hr-1",
    "citation": "H.R. 1",
    "congress": 119,
    "bill_type": "hr",
    "type_label": "House Bill",
    "number": 1,
    "title": "...",
    "short_title": "...",
    "chamber": "house",
    "status": "in_committee",
    "status_label": "In committee",
    "status_step": 1,
    "status_steps_total": 6,
    "is_enacted": false,
    "introduced_date": "2025-01-03",
    "latest_action": "Referred to the Committee on ...",
    "latest_action_date": "2025-01-06",
    "sponsor": { "bioguide": "F000477", "name": "...", "party": "...", "state": "..." },
    "cosponsor_count": 12,
    "policy_area": "Health",
    "subjects": ["..."],
    "official_summary": "...",
    "ai_summary": "...",
    "actions": [ { "date": "2025-01-06", "text": "...", "chamber": "house" } ],
    "sponsors": [ { "bioguide": "F000477", "name": "...", "is_sponsor": true } ],
    "url": "https://www.bill100.com/bills/119-hr-1",
    "sources": {
      "congress_gov": "https://www.congress.gov/bill/119th-congress/house-bill/1",
      "govtrack": "https://www.govtrack.us/congress/bills/119/hr1",
      "primary": "congress_gov"
    }
  },
  "request_id": "req_9f3ac1d0",
  "disclaimer": "Bill100 mirrors the public U.S. legislative record from Congress.gov a...",
  "attribution": "Data via Bill100 (free tier only)"
}

Errors

Structured, never silent

Every non-2xx response is JSON — never a fabricated fallback.

code	status	meaning
invalid_request	400	A required parameter is missing or malformed (e.g. `analyze` called without a `context` body field).
unauthorized	401	The Authorization header is missing a valid, unrevoked API key for an endpoint that requires one (e.g. AI impact analysis).
upgrade_required	402	The requested action (tailored AI impact analysis) needs a Pro or Scale plan.
not_found	404	No bill, legislator or record exists for the given id — never a fabricated fallback.
rate_limited	429	You've exceeded your plan's per-minute burst rate or the anonymous daily cap.
not_configured	503	A required backend credential isn't configured on our side.
upstream_unavailable / upstream_timeout	502 / 504	Congress.gov or GovTrack didn't respond in time. Safe to retry with backoff.
internal	500	An unexpected server error. Safe to retry; contact support if it persists.

error response

{
  "error": {
    "code": "not_found",
    "message": "No bill found with id '119-hr-999999'."
  },
  "request_id": "req_9f3ac1d1"
}

Rate limits

By plan

Tier	Burst	Volume	AI impact analyses
Anonymous	6/min	40/day	No API key — reads only
Free	10/min	500/mo	Not included
Pro	120/min	10,000/mo incl., then $2/1k	200/mo
Scale	600/min	100,000/mo incl., then $1/1k	2,000/mo

Full plan details at /pricing or the machine-readable /api/v1/pricing.

Policy areas

Filter bills by topic

The standard Congress.gov taxonomy — also returned by the list_policy_areas MCP tool.

Agriculture and FoodAnimalsArmed Forces and National SecurityArts, Culture, ReligionCivil Rights and Liberties, Minority IssuesCommerceCongressCrime and Law EnforcementEconomics and Public FinanceEducationEmergency ManagementEnergyEnvironmental ProtectionFamiliesFinance and Financial SectorForeign Trade and International FinanceGovernment Operations and PoliticsHealthHousing and Community DevelopmentImmigrationInternational AffairsLabor and EmploymentLawNative AmericansPublic Lands and Natural ResourcesScience, Technology, CommunicationsSocial WelfareSports and RecreationTaxationTransportation and Public WorksWater Resources Development

Endpoints

Every route

GET

/api/v1/bills

Auth optional

Search and list U.S. federal bills by keyword, congress, status, policy area, sponsor or chamber.

Param	In	Required	Description
q	query	no	Full-text query (title + summary), e.g. "artificial intelligence".
congress	query	no	Congress number, e.g. 119.
status	query	no	introduced \| in_committee \| passed_house \| passed_senate \| to_president \| enacted \| failed \| vetoed.
policy_area	query	no	Congress.gov policy area, e.g. "Health".
sponsor	query	no	Sponsor Bioguide id, e.g. F000477.
chamber	query	no	house \| senate.
sort	query	no	recent (default) \| introduced \| relevance.
limit	query	no	1–100 (default 20).
offset	query	no	Pagination offset.

curl "https://www.bill100.com/api/v1/bills?q=artificial%20intelligence&status=in_committee&limit=5"

GET

/api/v1/bills/{id}

Auth optional

Get one bill by id (e.g. 119-hr-1234) with its status, sponsors, action timeline and sources.

Param	In	Required	Description
id	path	yes	Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234.

curl https://www.bill100.com/api/v1/bills/119-hr-1

GET

/api/v1/bills/{id}/summary

Auth optional

Plain-English AI summary of what a bill does, who it affects and where it is in the process (cached).

Param	In	Required	Description
id	path	yes	Bill id, e.g. 119-hr-1234.

curl https://www.bill100.com/api/v1/bills/119-hr-1/summary

POST

/api/v1/bills/{id}/analyze

Requires paid key

Tailored AI impact analysis: how a bill affects a specific business/industry context. Metered (Pro/Scale).

Param	In	Required	Description
id	path	yes	Bill id, e.g. 119-hr-1234.
context	body	yes	Describe your organization/industry so the analysis is tailored.

curl -X POST https://www.bill100.com/api/v1/bills/119-hr-1/analyze \
  -H "Authorization: Bearer bill100_live_..." \
  -H "Content-Type: application/json" \
  -d '{"context":"a 40-person medical billing company in Texas"}'

GET

/api/v1/legislators/{id}

Auth optional

Get a member of Congress by Bioguide id, with the bills they have sponsored.

Param	In	Required	Description
id	path	yes	Bioguide id, e.g. F000477.

curl https://www.bill100.com/api/v1/legislators/F000477

GET

/api/v1/pricing

Auth optional

Machine-readable pricing — plans, included API calls, per-call overage, rate limits and features.

curl https://www.bill100.com/api/v1/pricing

Bill100 mirrors the public U.S. legislative record from Congress.gov and GovTrack and adds plain-English AI summaries. It is an information tool, not legal, compliance or lobbying advice, and it is not affiliated with the U.S. Congress or any government agency. AI summaries can simplify or omit detail — every bill links to the official source; verify there before you rely on it.