< back to index

HTTP request

GET https://api.wevoteusa.org/apis/v1/ballotItemHighlightsRetrieve (Jump to "Try It Now")

Required Parameters

Parameter name Value Description
api_key string (from post, cookie, or get (in that order)) The unique key provided to any organization using the WeVoteServer APIs

Optional Parameters

Parameter name Value Description
starting_year string For testing with old endorsement sites, the year election data should start in

Response

{
  "status": string,
  "success": boolean,
  "highlight_list": list [
    {
      "name": string,
      "we_vote_id": string,
      "prior": integer, ('1' if from a prior election)
    }
  ],
  "never_highlight_on": list [
     "*.wevote.us",
     "api.wevoteusa.org",
     "localhost"
  ]
}

Try It Now: API Variables

Retrieve all the candidates that might be highlighted on an endorsement guide.

Parameter name Value  
starting_year:

(opens in new window)