Skip to main content
GET
Get the fan's vote

Authorizations

x-api-key
string
header
required

Your organisation's API key, supplied by Dizplai. Send it on every request. It isn't a secret, so it can ship in your app: what a fan does is protected by the fan's token.

Authorization
string
header
required

The fan's token from your own login, sent as Authorization: Bearer <token>: a signed-in fan's or a guest's. Dizplai checks it against your login's details, agreed when you're set up, and a guest's token carries the guest claim agreed at the same time. Needed to vote, upload, send a message, and read the fan's own vote or messages.

Path Parameters

poll_id
string<uuid>
required

The poll's ID, from a list of experiences or polls. A poll's ID, a UUID.

Example:

"0192fa7b-8d41-7bbc-9b58-02311fc6ef8e"

Response

The fan's vote. Show their choice from it whenever you show the poll, and use it to tell when to show after_vote results. vote is null until the fan has voted and their first vote is counted: a fan who hasn't voted gets null, never 404. Not cached, as the answer belongs to one fan.

The fan's vote on this poll, or null if they haven't voted.

vote
Vote · object | null
required

The vote that counts, or null if the fan hasn't voted or their first vote isn't counted yet.