Skip to content

Poll

The poll of a status; omitted when the status has none. The counts of a poll of another server are those its server last reported. A poll whose author hides the votes of each option until it ends leaves out votes_count of its options until then. voted and own_votes describe the authenticated user’s vote and are omitted for anonymous requests.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
expires_at

When the poll ends; omitted when it has no end.

string format: date-time
expired
required

Whether the poll has ended. An ended poll takes no votes and shows its results.

boolean
multiple
required

Whether a vote may choose several options.

boolean
votes_count
required

The number of votes, one per chosen option.

integer
voters_count

The number of accounts that voted; omitted when it is unknown (a multiple-choice poll of another server that does not report it).

integer
options
required

The options, in order; a vote names them by their index in this list.

Array<object>
>= 1 items <= 20 items

One option of a poll.

object
title
required

The option as plain text.

string
votes_count

The number of votes for the option; omitted while the poll hides the votes of each option until it ends.

integer
voted

Whether the authenticated user voted in the poll.

boolean
own_votes

The indexes of the options the authenticated user voted for, in order.

Array<integer>

Example generated

{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"expires_at": "2026-04-15T12:00:00Z",
"expired": true,
"multiple": true,
"votes_count": 1,
"voters_count": 1,
"options": [
{
"title": "example",
"votes_count": 1
}
],
"voted": true,
"own_votes": [
1
]
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site