Open States Legislator Bulk Data

Legislator data in Open States is powered by the openstates/people repo which contains structured YAML files on all legislators in our system, past and present.

For convenience, we also make current legislators available as CSV files as described below.

Downloads

CSV files are published nightly, and available at https://data.openstates.org/people/current/[ABBR].csv, where [ABBR] is a state's postal code.

Fields

Fields with an asterisk are required, all others are optional.

These CSV files include a subset of the total data we collect deemed suitable for inclusion in a CSV file, see YAML Schema for all fields.

id*
ocd-person identifier assigned by Open States.
name*
Full name.
current_party*
Current party affiliation.
current_district*
Currently represented district name or number.
current_chamber*
Currently represented chamber (upper|lower).
given_name
aka first name.
family_name
aka last name.
gender
Male|Female|etc.
biography
A short bio published by the state.
birth_date
In YYYY-MM-DD format.
death_date
In YYYY-MM-DD format.
image
URL to official image.
email
Primary email address of legislator.
links
Semicolon separated list of official links for this person.
sources
Semicolon separated list of source URLs for this person.
capitol_address
Street address of capitol office.
capitol_voice
Phone number for capitol office.
capitol_fax
Fax number for capitol office.
district_address
Street address of district office.
district_voice
Phone number for district office.
district_fax
Fax number for district office.
twitter
youtube
instagram
facebook
Social media accounts.