Swap My Vote API
Swap My Vote does not have a conventional REST API, but we do
have a single end point to pre-populate some of the fields that
a user can choose.
This should be ideal for tactical voting campaigns which want to
encourage voters to follow their recommendations, and indeed we
would be very happy to see tactical voting sites integrate with
Swap My Vote. The below documentation is probably sufficient,
but if you need assistance then please
get in touch.
Available parameters are:
The party that the user is willing to vote for, say
The party that the user would ideally like to vote for, say if
all votes counted equally nationally.
The name of the default constituency for the user post-login.
This is useful if you want to refer a user for tactical voting
and you know in which constituency they are registered to vote,
as it will save them manually selecting that constituency.
The name must match one of the constituencies in the
this data set.
The same as for
above, except that rather than the name, it's the ONS id of
the constituency listed in the
the data set.
For example if a tactical voting site wishes to recommend a user
to vote for the Liberal Democrat candidate in the Somerton and Frome
consitituency, they could use this outbound link:
This one would also work:
The party names should be lowercased and use underscores instead
of spaces. We support 7 parties at the moment, with the follow
canonical names on Swap My Vote: