Below is a list of our available APIs. See also our admin tools.

Method Static Description
searchAll This api will search everything. Can be used for instant search.
Voter Basic Data
deviceIdGenerate Generate a device_id (store in cookie) that can be linked to a voter_id
donationWithStripe Process a stripe payment with a token (generated by stripe's checkout client library)
voterAddressRetrieve Retrieve an address for a voter that has previously been saved.
voterAddressSave Save or update address for an existing voter. Once the address is saved, the API server calls voterBallotItemsRetrieveFromGoogleCivic (If the address has actually changed.)
voterCount static Count the number of voters in the database.
voterCreate Create an empty voter entry attached to a voter_device_id
voterUpdate Save profile-related fields for an existing voter.
voterEmailAddressRetrieve Retrieve all of the voter's email addresses, including the status of each email.
voterEmailAddressSave Save or update email address for an existing voter.
voterEmailAddressSignIn Sign in based on an email_secret_key that get's emailed to voter.
voterEmailAddressVerify Verify an email address using an email_secret_key that get's emailed to voter.
voterPhotoSave - DEPRECATED, PLEASE USE voterUpdate Save photo (pulled from Facebook or Twitter) for an existing voter.
voterRetrieve Export key voter data to JSON format
Twitter, Facebook, Google
voterFacebookSignInRetrieve Retrieve the Facebook Sign In status based on voter_device_id.
voterFacebookSignInSave Save the results of Facebook sign in authentication.
voterFacebookSaveToCurrentAccount Save Facebook information (name) to current voter account.
facebookFriendsAction Request information about a voter's facebook friends.
facebookDisconnect Disconnect Voter's facebook account from We Vote account.
twitterIdentityRetrieve Find the kind of owner and unique id of this twitter handle, whether it be a candidate, organization, or individual voter. We use this to take an incoming URI like https://wevote.guide/RepBarbaraLee and return the owner of 'RepBarbaraLee'.
twitterSignInStart Start the process of signing in with Twitter.
twitterSignInRequestAccessToken Step 2 in the process of signing in with Twitter.
twitterSignInRequestVoterInfo Step 3 in the process of signing in with Twitter.
twitterSignInRetrieve Retrieve the Twitter user information following Twitter authentication.
twitterRetrieveIdsIFollow Retrieve the Twitter ids i follow.
voterTwitterSaveToCurrentAccount Save Twitter information to current voter account.
voterMergeTwoAccounts Combine two accounts into one. Leave existing voter_device_id in place, but link it to the remaining voter account.
voterSplitIntoTwoAccounts Split one account into two accounts. Used for un-linking a Twitter account from the current voter account.
voterSignOut Delete the voter sign in session. (Remove voter_device_id from database.)
GeoLocation
voterLocationRetrieveFromIP Retrieve a printable string with the location of the voter, based on the browser's IP address. Ex/ "Oakland, CA 94602"
Ballot Contest Data
ballotItemOptionsRetrieve static c3 Retrieve a complete list of offices, candidates or measures in the specified election(s). This information is not organized in a hierarchy, but is instead provided in a simple list to help with auto-complete and browser-side quick search features.
voterBallotItemsRetrieve c3 Retrieve a list of ballot items to display for the current voter from the We Vote database. These entries would have been previously retrieved from Google Civic with voterBallotItemsRetrieveFromGoogleCivic.
voterBallotItemsRetrieveFromGoogleCivic c3 Tell the We Vote server to reach out to the Google Civic API and retrieve a list of ballot items for the current voter (based on the address saved with voterAddressSave), and store them in the We Vote database so we can display them with voterBallotItemsRetrieve, and other API calls.
voterBallotListRetrieve c3 Retrieve a list of users ballots from different elections from the We Vote database.
electionsRetrieve static c3 Return a list of all elections, and include ballot location options so a voter can jump to sample ballots.
electionsSyncOut static c3 Provide another We Vote Server a complete listing of all public elections information.
pollingLocationsSyncOut c3 Provide another We Vote Server a complete listing of all polling locations.
Offices, Candidates & Measures
ballotItemRetrieve static c3 Retrieve details about one office, candidate or measure. This is a wrapper for officeRetrieve, candidateRetrieve and measureRetrieve.
ballotItemsSyncOut c3 Provide another We Vote Server a complete listing of all ballot items information.
ballotReturnedSyncOut c3 Provide another We Vote Server a complete listing of all ballot_returned items.
officeRetrieve static c3 Retrieve details about one office. Alternate to ballotItemRetrieve.
candidateRetrieve static c3 Retrieve details about one candidate. Alternate to ballotItemRetrieve.
candidatesRetrieve static c3 Retrieve a list of candidates (summary information) competing for an office.
measureRetrieve static c3 Retrieve details about one measure. Alternate to ballotItemRetrieve.
quickInfoRetrieve static c3 Information necessary to populate a bubble next to a ballot item.
politiciansSyncOut c3 Provide another We Vote Server a complete listing of all public politician information.
officesSyncOut c3 Provide another We Vote Server a complete listing of all public office information.
candidatesSyncOut c3 Provide another We Vote Server a complete listing of all public candidates information.
measuresSyncOut c3 Provide another We Vote Server a complete listing of all public measures information.
Positions (Support, Oppose, Info Only), Bookmarks and Like's
positionListForBallotItem A list of all positions (support/oppose/info) for this Ballot Item (Office, Candidate or Measure) from organizations, friends, and public figures this voter follows.
positionListForOpinionMaker A list of all positions (support/oppose/info) for this Opinion Maker (Organization or Public Figure) relating to Candidates, Measures or Offices.
positionListForVoter A list of all positions (support/oppose/info) for this voter relating to Candidates, Measures or Offices.
positionsCountForAllBallotItems A list of the support and oppose counts for all Ballot Items (Candidate or Measure) from organizations, friends, and public figures this voter follows.
positionsCountForOneBallotItem A list of the support and oppose counts for one Ballot Item (Candidate or Measure) from organizations, friends, and public figures this voter follows.
positionSupportCountForBallotItem A single number showing the total supporters for this Ballot Item (Candidate or Measure) from organizations, friends, and public figures this voter follows.
positionOpposeCountForBallotItem A single number showing the total that oppose this Ballot Item (Candidate or Measure) from organizations, friends, and public figures this voter follows.
positionPublicSupportCountForBallotItem static/ public c3 A single number showing the total supporters for this Ballot Item (Candidate or Measure) from organizations and public figures. (NOT specific to one voter.)
positionPublicOpposeCountForBallotItem static/ public c3 A single number showing the total that oppose this Ballot Item (Candidate or Measure) from organizations and public figures. (NOT specific to one voter.)
positionRetrieve static/ public c3 Retrieve one position based on unique position identifier. (Public positions can be served by c3 network. Private positions served by other network.)
positionSave c3 Save a new position or update an existing position. Mostly for volunteer tools and voter guides. For the typical voter, we use voterPositionCommentSave, voterSupportingSave, voterOpposingSave, voterStopSupportingSave, and voterStopOpposingSave.
voterAllPositionsRetrieve Retrieve all support/oppose stances held by this voter in one list. For a list of positions with full data, use positionListForVoter.
voterAllBookmarksStatusRetrieve Retrieve all of the voter's bookmarks.
voterPositionRetrieve Retrieve the voter's position based on voter_device_id and ballot item id.
voterPositionCommentSave Save the voter's comment based on voter_device_id and ballot item id.
voterPositionLikeOnSave Mark that the voter wants to 'Like' this position.
voterPositionLikeOffSave Remove a Like that the voter set on a position.
voterPositionLikeStatusRetrieve Has this voter 'Liked' this position?
positionLikeCount The total number of Likes that a position has received, either from the perspective of your network of friends, or the entire network.
voterSupportingSave Save or update one voter's support for one candidate or measure
voterStopSupportingSave Save or update one voter's lack of support for one candidate or measure
voterOpposingSave Save or update one voter's opposition for one candidate or measure
voterStopOpposingSave Save or update one voter's lack of opposition for one candidate or measure
voterBookmarkOnSave Save or create private 'bookmark on' state for the current voter for a measure, an office or candidate.
voterBookmarkOffSave Save or create private 'bookmark off' state for the current voter for a measure, an office or candidate.
voterBookmarkStatusRetrieve Has the voter bookmarked this measure, office or candidate?
positionsSyncOut c3 Provide another We Vote Server a complete listing of all public positions information.
Organizations, People & Voter Guides
organizationCount static Count the number of organizations in the database.
organizationFollow Store that the voter wants to follow this organization.
organizationFollowIgnore Store that the voter wants to ignore this organization.
organizationStopFollowing Store that the voter wants to stop following this organization.
organizationSuggestionTasks Retrieve suggested organizations to follow generated from twitter ids i follow or organization of my friends follow.
organizationRetrieve static Retrieve one organization based on unique identifier.
organizationSave c3 Save a new organization or update an existing organization.
organizationSearch c3 Search for organizations to find any organization that contains any of the search terms.
organizationsFollowedRetrieve Return a list of the organizations followed. See also voterGuidesFollowedRetrieve, which returns the most recent voter guide for each organization the voter follows.
voterGuidePossibilityRetrieve Has a volunteer marked this URL as a voter guide?
voterGuidePossibilitySave Mark this URL as a voter guide.
voterGuideSave c4 Save new or existing voter guide.
voterGuidesRetrieve c4 Retrieve voter guides using a variety of search criteria.
voterGuidesSyncOut c3 Provide another We Vote Server a complete listing of all voter guides.
voterGuidesFollowedRetrieve Retrieve a list of the most recent voter guide from each organization the voter follows. See also organizationsFollowedRetrieve, which returns a list of organizations the voter follows.
voterGuideFollowersRetrieve Retrieve a list of followers of this voter guide.
voterFollowAllOrganizationsFollowedByOrganization Follow all organizations being followed by another organization.
voterGuidesFollowedByOrganizationRetrieve Retrieve a list of the most recent voter guide from each organization the organization follows. See also organizationsFollowedRetrieve, which returns a list of organizations the voter follows.
voterGuidesIgnoredRetrieve Retrieve a list of the most recent voter guide from each organization the voter ignores.
voterGuidesToFollowRetrieve Retrieve a list of voter guides that a voter might want to follow.
voterGuidesUpcomingRetrieve Retrieve all upcoming voter guides. (Implemented as cached/static json file.)
pledgeToVoteWithVoterGuide A voter pledges to vote as the Voter Guide recommends.
organizationsSyncOut c3 Provide another We Vote Server a complete listing of all public organization information.
issueFollow Allow a voter to follow one issue.
issuesRetrieve c3 Retrieve complete listing of all issues.
issuesSyncOut c3 Provide another We Vote Server a complete listing of all issues.
retrieveIssuesToFollow Retrieve listing of all issues for the voter to follow.
organizationLinkToIssueSyncOut This is the summary of the way that public organizations are categorized by issues. For example, if I want to find all organizations that are related to climate change, this is the data that tells me this.
issuesLinkedToOrganization Retrieves list of issues that are linked to the Organization
issuesToLinkToForOrganization Retrieves list of issues that the Organization is not linked to already
organizationLinkToIssue Links or unlinks an Organization to an Issue
Voter Friends
emailBallotData Send ballot to self or friends by email address.
friendInvitationByEmailSend Send invitations to friends by email address.
friendInvitationByEmailVerify Accept an invitation to be someone's friend based on a secret key.
friendInvitationByFacebookSend Send invitations to friends by facebook.
friendInvitationByFacebookVerify Accept an invitation from facebook to be someone's friend.
friendInvitationByWeVoteIdSend Invite a friend to be your friend from a 'suggested friends' list.
friendInviteResponse Respond to a friend request.
friendList Request information about a voter's friends, including invitations to become a friend, a list of current friends, and friends you share in common with another voter.
Analytics
saveAnalyticsAction Save an entry in the We Vote Analytics system so we can publish daily, monthly, election and sitewide reports.
Voter Language
Messages