Endpoint Reference

Paths, parameters, and examples

Use this page for the exact route list, accepted filters, and example request shapes. Shared conventions such as authentication and pagination live in Docs, and practical request patterns live in Recipes.

Version 1 covers federal legislative data.
List endpoints stay light. Detail endpoints can return more when that saves follow-up requests.

Endpoint reference

Each group below lists the supported routes, filters, and example requests. For shared integration behavior such as pagination and includes, use Docs.

Bills

Browse federal bills and laws. When you need more than the main bill record, you can add related data to the same response.

GET
/api/v1/bills

List federal bills with filters for Congress, type, chamber, sponsor, status, and keyword query.

Parameters: q, congress, type (HR|S|HJRES|SJRES|HCONRES|SCONRES|HRES|SRES), chamber (house|senate), status, sponsor_bioguide_id, page, per_page
Example: /api/v1/bills?congress=119&type=HR&per_page=20
GET
/api/v1/bills/{congress}/{type}/{number}

Return one bill. Add actions, text versions, amendments, committees, related bills, votes, and enacted law links in the same response.

Parameters: include
Example: /api/v1/bills/119/HR/1?include=actions,texts,amendments,related,laws,votes
GET
/api/v1/laws

List public and private laws with linkage back to the originating bill when available.

Parameters: q, congress, law_type (public|private), page, per_page
Example: /api/v1/laws?congress=119&law_type=public
GET
/api/v1/laws/{congress}/{law_type}/{law_number}

Return one law plus the linked bill object.

Parameters: none
Example: /api/v1/laws/119/public/21

Votes

Browse House and Senate votes, and add the member-by-member roll call when you need it.

GET
/api/v1/votes

List House and Senate votes with filters for Congress, session, chamber, bill linkage, result, and question text.

Parameters: q, congress, session, chamber (house|senate), bill_type (HR|S|HJRES|SJRES|HCONRES|SCONRES|HRES|SRES), bill_number, result, page, per_page
Example: /api/v1/votes?congress=119&chamber=house&per_page=20
GET
/api/v1/votes/{congress}/{session}/{chamber}/{vote_number}

Return one vote. Add include=results to include the member-by-member roll call.

Parameters: include
Example: /api/v1/votes/119/1/house/304?include=results

People

Look up current members and add biography, term history, or committee assignments when needed, including member biographies that are otherwise awkward to assemble cleanly from official sources.

GET
/api/v1/legislators

List legislators with filters for Congress, chamber, party, state, and name query.

Parameters: q, congress, chamber (house|senate), party, state, page, per_page
Example: /api/v1/legislators?congress=119&state=PA
GET
/api/v1/legislators/{bioguide_id}

Return one legislator with optional biography, terms, and committee memberships. Biography is available as a detail-only include.

Parameters: include
Example: /api/v1/legislators/A000370?include=biography,terms,committee_memberships

Institutions

Browse current federal committees and, if needed, include the members tied to each one. Committee activity subresources for meetings and nominations are current-Congress only.

GET
/api/v1/committees

List committees with filters for chamber, type, committee query, and current/all scope.

Parameters: q, chamber (house|senate|joint), type, current (current|all), page, per_page
Example: /api/v1/committees?chamber=House&type=Standing
GET
/api/v1/committees/{code}

Return one committee with parent committee links and, if requested, the member list with direct legislator links.

Parameters: include
Example: /api/v1/committees/HSJU05?include=memberships
GET
/api/v1/committees/{code}/meetings

List committee meetings and hearings for the current Congress only, with pagination and official event links.

Parameters: page, per_page
Example: /api/v1/committees/SSJU00/meetings?per_page=5
GET
/api/v1/committees/{code}/nominations

List committee nominations for the current Congress only. Most useful for Senate committees.

Parameters: page, per_page
Example: /api/v1/committees/SSFR00/nominations?per_page=5

Topics

Browse topic pages and the federal bills grouped under each subject area.

GET
/api/v1/topics

List topic slugs and coverage windows for fast discovery.

Parameters: q, page, per_page
Example: /api/v1/topics?q=appropriation&per_page=10
GET
/api/v1/topics/{slug}

Return one topic with coverage, congress counts, bills in data, and pagination links in top-level meta.

Parameters: congress, page, per_page
Example: /api/v1/topics/abandonment-of-family?congress=110&per_page=3

Next step

If you want copy-ready workflows instead of route listings, go to Recipes. If you still need the integration rules, go back to Docs.