Working with the Democracy Elections API? Learn how to integrate co-branded, authoritative, and comprehensive TurboVote Election Guides and State Voting Hubs instead of building native guides from scratch.
Election Guides
Transform the Democracy Works Elections API canonicalURL into a TurboVote Election Guide:
- Use Democracy Works Elections API getElections endpoint
- Get canonicalURL e.g. https://voting.democracy.works/en/elections/wi/2024-11-05.html
- Replace https://voting.democracy.works/en with partner hostname https://example.turbovote.org
- Drop .html
- Integrate link into campaign, site or app:
- Destination Site URL: https://example.turbovote.org/elections/wi/2024-11-05
- Add page embed transport URL parameter (tv-p=/) to open on any page embedding TurboVote https://planmyvote.org/vote?tv-p=/elections/wi/2024-11-05
- Add embed parameters to embed on a new page: https://example.turbovote.org/elections/wi/2024-11-05?embed=window&partner=01gzpamk4zqm16ts3yjxt668tk&placement=hub-home
- Link to page using Embed Page Transport URLs e.g. https://planmyvote.org/vote?tv-p=/elections/wi/2024-11-05
State Voting Hubs
Transform the Democracy Works Elections API canonicalURL into a TurboVote State Voting Hub:
- Use Democracy Works Elections API getStateAuthorities endpoint
- Get canonicalURL e.g. https://voting.democracy.works/en/vote/al.html
- Replace https://voting.democracy.works/en/vote/ with partner hostname
- https://example.turbovote.org/how-to-vote/
- Drop .html
- Integrate link into campaign, site or app:
- Destination Site URL: https://example.turbovote.org/how-to-vote/al
- Add page embed transport URL parameter (tv-p=/) to open on any page embedding TurboVote https://planmyvote.org/vote?tv-p=/how-to-vote/al
- Add embed parameters to embed on a new page: https://example.turbovote.org/how-to-vote/al?embed=window&partner=01gzpamk4zqm16ts3yjxt668tk&placement=hub-home&r=tvhub&lang=en
- Link to page using Embed Page Transport URLs e.g. https://planmyvote.org/vote?tv-p=/how-to-vote/al&tv-embed=window
Explore TurboVote’s growing set of User Experience Developer Tools.