Open States GraphQL API
The Open States GraphQL API (v2) provides programmatic access to US state legislative data through a flexible GraphQL interface. The API exposes data covering all 50 states, Washington DC, and Puerto Rico, including bills, legislators, committees, jurisdictions, legislative sessions, and voting records. Queries support filtering by jurisdiction, session, chamber, subject, sponsor, and date, as well as geolocation-based legislator lookups using latitude and longitude coordinates.
Overview
Open States GraphQL API is a GraphQL API specification published by Open States on the APIs.io network.
The Open States GraphQL API (v2) provides programmatic access to US state legislative data through a flexible GraphQL interface. The API exposes data covering all 50 states, Washington DC, and Puerto Rico, including bills, legislators, committees, jurisdictions, legislative sessions, and voting records. Queries support filtering by jurisdiction, session, chamber, subject, sponsor, and date, as well as geolocation-based legislator lookups using latitude and longitude coordinates.
The GraphQL endpoint is available at https://openstates.org/graphql/. documentation is published at https://docs.openstates.org/graphql/.
The specification includes 3 reference links.
Tagged areas include Government, Legislative Data, Civic Technology, State Legislature, and Bills.
Endpoint
References
- Documentation https://docs.openstates.org/graphql/
- GettingStarted https://docs.openstates.org/api-v3/
- Reference https://github.com/openstates/openstates.org/tree/main/graphapi
Related API Specs
Work with this as data
Every GraphQL schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for graphql
4 MCP tools reach this
find_graphqlBrowse and filter every GraphQL schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/graphql/openstates-graphql"curl "https://apis.io/api/v1/graphql?limit=25"Discovery needs no key. Ratings and market analysis are Pro.