organizationsFollowedRetrieve
< back to index
HTTP request
GET https://api.wevoteusa.org/apis/v1/organizationsFollowedRetrieve (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 |
Optional Parameters
| Parameter name |
Value |
Description |
| auto_followed_from_twitter_suggestion |
boolean |
True default retrieve auto followed endorsers.If False, retrieve all endorsers followed by voter(includes twitter auto followed endorsers) |
Response
{
"status": string,
"success": boolean,
"voter_device_id": string (88 characters long),
"organization_list": list
[
"organization_id": integer (the id of the organization found),
"organization_we_vote_id": string (the organization identifier that moves server-to-server),
"organization_name": string (value from Google),
"organization_website": string (website address),
"organization_twitter_handle": string (twitter address),
"twitter_followers_count": integer,
"twitter_description": string,
"organization_email": string,
"organization_facebook": string,
"organization_photo_url_large": string,
"organization_photo_url_medium": string,
"organization_photo_url_tiny": string,
"politician_we_vote_id": 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
A list of all endorsers followed by this voter includes automatically followed from twitter. (Or show the endorsers this voter is following automatically from twitter only if auto_followed_from_twitter_suggestion is True.)