< back to index
HTTP request
GET https://api.wevoteusa.org/apis/v1/voterGuidePossibilityPositionsRetrieve (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 |
voter_guide_possibility_id |
integer |
This id of the VoterGuidePossibility is required. |
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 |
voter_guide_possibility_position_id |
integer |
If you enter voter_guide_possibility_position_id the query will be limited to just this entry. |
Response
{
"status": string,
"success": boolean,
"voter_guide_possibility_id": integer,
"possible_position_list": list [
{
"possibility_position_id": integer,
"possibility_position_number": integer,
"ballot_item_name": string,
"ballot_item_image_url_https_medium": string,
"candidate_twitter_handle": string,
"candidate_we_vote_id": string,
"edit_position_url": string,
"google_civic_election_id": string,
"measure_we_vote_id": string,
"more_info_url_stored": string,
"more_info_url": string,
"office_we_vote_id": string,
"organization_name": string,
"organization_twitter_handle": string,
"organization_we_vote_id": string,
"political_party": string,
"position_should_be_removed": boolean,
"position_stance": string,
"position_stance_stored": string,
"position_we_vote_id": string,
"possibility_should_be_deleted": boolean,
"possibility_should_be_ignored": boolean,
"statement_text": string,
"statement_text_stored": string,
"state_code": string,
"withdrawn_from_election": boolean,
"withdrawal_date": date,
}],
}
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. |
VOTER_GUIDE_POSSIBILITY_NOT_FOUND |
A voter guide possibility was not found at that URL. |
VOTER_GUIDE_POSSIBILITY_FOUND_WITH_URL |
A voter guide possibility entry was found. |
Try It Now: API Variables
Retrieve all the possible endorsements scraped from this particular page.