< 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,
   ],
}

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.)

Parameter name	Value
voter_device_id:
auto_followed_from_twitter_suggestion:	True False

(opens in new window)