Districts and officeholders
The districts behind every race, who holds each seat now, and who represents a place. Locations work as described under Locations.
Endpoints
| Endpoint | What |
|---|---|
GET /v1/districts | Electoral districts with OCD ids and Census GEOIDs. states, levels, types, elections, q, include_retired |
GET /v1/districts/{id} | One district, who holds its seat, and its upcoming elections. boundary=true adds its GeoJSON outline where one is drawn |
GET /v1/representatives | Who represents a location (or lat+lng): U.S. senators and representative, governor and statewide offices, state legislators. A ZIP code, city or county gives everyone whose district overlaps it; a state, everyone in a state or federal office there |
GET /v1/officeholders | People in office now, with party, term, phone, email, offices, website and photo. states, offices, levels, districts (OCD ids), q |
GET /v1/officeholders/{person_id} | One officeholder |
List parameters take comma-separated values: categories=labor,newspaper.
Officeholders
Officeholders come from Open States and are refreshed as it updates. Each has a person_id that stays the same across terms and offices, the office and the office_title the state uses (Assemblymember, Delegate), and the seat’s district, district_ocd_id and census_geoid. A seat’s district is the one its holder was elected in, which can differ from the district on the next ballot where lines have been redrawn. Local offices other than the D.C. Council aren’t included yet.