# API documentation

Canonical URL: https://www.thelobbynews.com/developers/api/documentation

Bills, actions, text, sponsors, votes, amendments, members and committees, as Congress.gov publishes them, in one JSON API. The higher plan adds our own analysis: editorial summaries with citations, facts pulled from each bill, topic scores and search by meaning.

## Quickstart

```
curl "https://api.thelobbynews.com/v1/bills?congress=119&limit=5" \
  -H "Authorization: Bearer lobby_live_..."
```

## Guides

- [Authentication](https://www.thelobbynews.com/developers/api/documentation/authentication.md): Every request carries an API key in the Authorization header.
- [Pagination](https://www.thelobbynews.com/developers/api/documentation/pagination.md): Lists return a page of results and a cursor for the next one.
- [Errors](https://www.thelobbynews.com/developers/api/documentation/errors.md): Every error is JSON with a code you can branch on and a message that says what to do.
- [Limits, allowance and credit](https://www.thelobbynews.com/developers/api/documentation/limits-and-credit.md): A monthly allowance, prepaid credit past it, and a per-minute limit.
- [AI agents](https://www.thelobbynews.com/developers/api/documentation/ai-agents.md): Agents without an account can pay per request, and every site page maps to its API address.

## Endpoints

### Search

- [GET /v1/search](https://www.thelobbynews.com/developers/api/documentation/search/search-bills.md): Search bills (Data + Analysis)

### Bills

- [GET /v1/bills](https://www.thelobbynews.com/developers/api/documentation/bills/list-bills.md): List bills
- [GET /v1/bills/{billId}](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill.md): Get a bill
- [GET /v1/bills/{billId}/actions](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-actions.md): Bill actions
- [GET /v1/bills/{billId}/text-versions](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-text-versions.md): Bill text versions
- [GET /v1/bills/{billId}/sections](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-sections.md): Bill sections
- [GET /v1/bills/{billId}/sponsors](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-sponsors.md): Bill sponsors
- [GET /v1/bills/{billId}/committees](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-committees.md): Bill committees
- [GET /v1/bills/{billId}/subjects](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-subjects.md): Bill subjects
- [GET /v1/bills/{billId}/related](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-related.md): Related bills
- [GET /v1/bills/{billId}/laws](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-laws.md): Bill laws
- [GET /v1/bills/{billId}/timeline](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-timeline.md): Bill timeline
- [GET /v1/bills/{billId}/votes](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-votes.md): Bill votes
- [GET /v1/bills/{billId}/amendments](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-amendments.md): Bill amendments
- [GET /v1/bills/{billId}/crs-summaries](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-crs-summaries.md): CRS summaries
- [GET /v1/bills/{billId}/summary](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-web-summary.md): Editorial summary (Data + Analysis)
- [GET /v1/bills/{billId}/facts](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-facts.md): Bill facts (Data + Analysis)
- [GET /v1/bills/{billId}/topic-scores](https://www.thelobbynews.com/developers/api/documentation/bills/get-bill-topic-scores.md): Topic scores (Data + Analysis)

### Members

- [GET /v1/members](https://www.thelobbynews.com/developers/api/documentation/members/list-members.md): List members
- [GET /v1/members/{bioguideId}](https://www.thelobbynews.com/developers/api/documentation/members/get-member.md): Get a member
- [GET /v1/members/{bioguideId}/votes](https://www.thelobbynews.com/developers/api/documentation/members/list-member-votes.md): Member votes
- [GET /v1/members/{bioguideId}/bills](https://www.thelobbynews.com/developers/api/documentation/members/list-member-bills.md): Member bills

### Votes

- [GET /v1/votes](https://www.thelobbynews.com/developers/api/documentation/votes/list-votes.md): List votes
- [GET /v1/votes/{voteId}](https://www.thelobbynews.com/developers/api/documentation/votes/get-vote.md): Get a vote

### Amendments

- [GET /v1/amendments](https://www.thelobbynews.com/developers/api/documentation/amendments/list-amendments.md): List amendments
- [GET /v1/amendments/{amendmentId}](https://www.thelobbynews.com/developers/api/documentation/amendments/get-amendment.md): Get an amendment

### Committees

- [GET /v1/committees](https://www.thelobbynews.com/developers/api/documentation/committees/list-committees.md): List committees
- [GET /v1/committees/{committeeCode}](https://www.thelobbynews.com/developers/api/documentation/committees/get-committee.md): Get a committee

## Machine-readable

- [OpenAPI 3.1](https://api.thelobbynews.com/v1/openapi.json)
- [API catalog (RFC 9727)](https://api.thelobbynews.com/.well-known/api-catalog)
- [llms.txt for the API](https://api.thelobbynews.com/llms.txt)
- [Authentication for agents](https://api.thelobbynews.com/auth.md)