Open States Bulk Data

Open States makes almost all of our data available in bulk. Unless otherwise noted data is provided under a public domain dedication but attribution is greatly appreciated and very helpful.

If you're looking for details on our API, visit: GraphQL API or API v3.

If you notice any data irregularities, issue reports are very useful: Report an Issue

Legislator Data

Structured data files for every legislator we've tracked, stored in version control.

Downloads
YAML (repository)
CSV
Source
Legislator Data is obtained by scraping state legislative sites and updated via curated contributions from users.
Documentation
YAML Schema
CSV Schema
Update Schedule
This data is updated periodically throughout the session on an as-needed basis. If data looks out of data consider submitting an issue or pull request.

Bill & Vote CSV Data

CSV files representing all bills & votes, available on a per-session basis.

Link
Session CSV Archives
Source
Data is obtained by scraping state legislative sites using our scrapers.
Documentation
Documentation TBD, for now get in touch if you have questions.
Update Schedule
This data will update monthly, get in touch if you need specific data.

Bill & Vote JSON Data

JSON files representing all bills & votes, available on a per-session basis (Include full text).

Link
Session JSON Archives
Source
Data is obtained by scraping state legislative sites using our scrapers.
Documentation
Documentation TBD, for now get in touch if you have questions.
Update Schedule
This data will update monthly, get in touch if you need specific data.

Geographic Data

Polygons representing the state legislative districts.

Link
Boundary Data Documentation
Source
Geographic boundary data is sourced primarily from the Census, and we provide it via JSON files.
Documentation
Boundary Data Documentation
Update Schedule
The latest iteration of this data was created in November 2018.

PostgreSQL Data Dump

Nearly-complete database dump of Open States' public data.

Links
April 2024 Schema
April 2024 Data
Source
Combined people, bill, vote, etc. data, sources vary but are recorded in database.
Documentation
Currently only supported in the context of restoring a database for development. No guarantees are made about internal schema changes or availability.
Update Schedule
This data updates regularly throughout the month, typically no more than a day or two behind what is online.
At the beginning of the month, the auto-generated link above may point to files that don't exist yet.
Download other versions of the SQL dumps by following this pattern: https://data.openstates.org/postgres/monthly/YYYY-MM-public.pgdump