< back to index

HTTP request

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

Required Parameters

Parameter name Value Description
voter_device_id string An 88 character unique identifier linked to a voter record on the server
api_key string (from post, cookie, or get (in that order)) The unique key provided to any organization using the WeVoteServer APIs
measure_id integer The unique internal identifier for this measure (either measure_id OR measure_we_vote_id required -- not both. If it exists, measure_id is used instead of measure_we_vote_id)
measure_we_vote_id string The unique identifier for this measure across all networks (either measure_id OR measure_we_vote_id required -- not both. If it exists, measure_id is used instead of measure_we_vote_id)

Response

{
  "status": string,
  "success": boolean,
  "ballot_item_display_name": string,
  "district_name": string,
  "election_display_name": string,
  "google_civic_election_id": integer,
  "id": integer,
  "kind_of_ballot_item": string (CANDIDATE, MEASURE),
  "last_updated": string (time in this format %Y-%m-%d %H:%M:%S),
  "maplight_id": integer,
  "measure_subtitle": string,
  "measure_text": string,
  "measure_url": string,
  "no_vote_description": string,
  "ocd_division_id": string,
  "regional_display_name": string,
  "state_code": string,
  "state_display_name": string,
  "vote_smart_id": string,
  "we_vote_id": string,
  "yes_vote_description": string,
}

Response Status Codes

Code Description
VALID_VOTER_DEVICE_ID_MISSING Cannot proceed. A valid voter_device_id parameter was not included.
VALID_VOTER_ID_MISSING Cannot proceed. A valid voter_id was not found.

Try It Now: API Variables

Retrieve detailed information about one measure.

Parameter name Value  
voter_device_id:
measure_id:
measure_we_vote_id:

(opens in new window)