# PollUnit - [Welcome to PollUnit](https://api.pollunit.com/index.md): Programmatic access to PollUnit — create, manage, and read polls via the API. - [List poll options](https://api.pollunit.com/api-reference/options/list-poll-options.md): Returns one page of options. The options have a hierarchy with varying levels. API calls can navigate through this hierarchy by passing a parent_option_id. The default page size depends on the poll type and the poll's options_per_page setting; use the X-Total-Pa… - [Create option](https://api.pollunit.com/api-reference/options/create-option.md): Adds an option to the poll. The option class is derived from the poll or, when a parent_option_id is given, from the parent option. A private token creates the option on behalf of its user, a public token creates it anonymously — which the poll has to allow through allow_new_options. Options with a… - [Get option](https://api.pollunit.com/api-reference/options/get-option.md) - [Delete option](https://api.pollunit.com/api-reference/options/delete-option.md): Removes the option and its child options. Admin access through the admin_hash may delete every option; otherwise the option has to belong to the requesting user, the poll has to still allow changes and the option must not have votes. Options that were paid for through a voting wallet can never be de… - [Update option](https://api.pollunit.com/api-reference/options/update-option.md): Changes an existing option. Only the given attributes are written, the others keep their value. Admin access through the admin_hash may change every option; otherwise the option has to belong to the requesting user and the poll has to still allow changes. Options that already collected votes can onl… - [List polls](https://api.pollunit.com/api-reference/polls/list-polls.md): Returns one page of polls, newest first. Use the X-Total-Pages / X-Total-Count response headers to page through the full list. - [Create poll](https://api.pollunit.com/api-reference/polls/create-poll.md) - [Get poll](https://api.pollunit.com/api-reference/polls/get-poll.md) - [Delete poll](https://api.pollunit.com/api-reference/polls/delete-poll.md) - [Update poll](https://api.pollunit.com/api-reference/polls/update-poll.md) - [List poll participants](https://api.pollunit.com/api-reference/voters/list-poll-participants.md): Returns one page of the participants of the poll. Polls that hide their participants only list them with admin access. Use the X-Total-Pages / X-Total-Count response headers to page through the full list. - [Create participant](https://api.pollunit.com/api-reference/voters/create-participant.md): Adds a participant to the poll, which is the object the votes of one person belong to. A private token creates the participant on behalf of its user, a public token creates it anonymously and the X-POLLUNIT-USER-IDENTIFIER header decides which anonymous user it belongs to. The call is idempotent for… - [Get participant](https://api.pollunit.com/api-reference/voters/get-participant.md) - [Delete participant](https://api.pollunit.com/api-reference/voters/delete-participant.md): Removes the votes of the participant, and the participant record itself when deleting it is allowed. Deleting the votes requires that the participation belongs to the requesting user and the poll still accepts votes, or admin access to a survey, or admin access with an account that allows deleting;… - [Update participant](https://api.pollunit.com/api-reference/voters/update-participant.md): Changes an existing participant. Only the given attributes are written, the others keep their value. The participant has to belong to the requesting user — identified by the private token or, for anonymous users, by the X-POLLUNIT-USER-IDENTIFIER header — and the poll has to still accept votes. Admi… - [List poll votes](https://api.pollunit.com/api-reference/votes/list-poll-votes.md): Returns one page of the votes of the poll, oldest first. Polls that hide their votes only list them with admin access. Pass `voter_id` or `option_id` to list the votes of one participant or one option. Use the X-Total-Pages / X-Total-Count response headers to page through the full list. - [Create vote](https://api.pollunit.com/api-reference/votes/create-vote.md): Casts a vote of a participant for an option. Create the participant first; the participant has to belong to the requesting user — identified by the private token or, for anonymous users, by the X-POLLUNIT-USER-IDENTIFIER header. The poll has to accept votes, and its vote limits and access restrictio… - [Get vote](https://api.pollunit.com/api-reference/votes/get-vote.md): Polls that hide their votes only return the own votes of the requesting user, or any vote with admin access. For polls with `vote_per_day` only the votes of the current day are found. - [Delete vote](https://api.pollunit.com/api-reference/votes/delete-vote.md): Removes a vote. Requires that the vote belongs to the requesting user and the poll still accepts votes, or admin access with an account that allows deleting. Votes of polls with a voting wallet can not be deleted. For polls with `vote_per_day` only the votes of the current day can be deleted. - [Update vote](https://api.pollunit.com/api-reference/votes/update-vote.md): Changes the value of a vote. The vote has to belong to the requesting user and the poll has to still accept votes. Admins may additionally change the votes of other participants of voting and table polls. Polls that sell votes do not allow lowering `vote`, and answer with the payment page instead of… ## OpenAPI Specs - [openapi](/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.