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.