HTTP request
GET https://api.wevoteusa.org/apis/v1/politiciansQuery (Jump to "Try It Now")
Optional Parameters
Parameter name | Value | Description |
race_office_level | list of strings | Limit the politicians returned to: Federal, State, Local |
search_text | string | The word or words we want to search for in all politicians. |
state | string | Limit the politicians returned to this state. |
Response
{ "status": string, "success": boolean, "index_start": integer, "returned_count": integer, "total_count": integer, "kind": string, "state": string, "politicians": list [ "id": integer, "status": string, "success": boolean, "ballot_item_display_name": string, "kind_of_ballot_item": string, "last_updated": string (time in this format %Y-%m-%d %H:%M:%S), "office_held_we_vote_id": string, "party": string, "politician_we_vote_id": string, "politician_photo_url_large": string, "politician_photo_url_medium": string, "politician_photo_url_tiny": string, "we_vote_id": string, ], }
Response Status Codes
Code | Description |
POLITICIANS_RETRIEVED | Candidates were returned. |
NO_POLITICIANS_RETRIEVED | There are no politicians stored for this Office. |
Try It Now: API Variables
Retrieve all the politicians in a particular state.