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.