< back to index

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.

Parameter name Value  
search_text:
state:

(opens in new window)