Results
Read tallies for an event or one position.
Endpoints
| Method | Path | Scope | Description |
|---|---|---|---|
GET | /voting-events/:idOrCode/results | read | Get results for all positions. |
GET | /voting-events/:idOrCode/results/:positionId | read | Get results for one position. |
These endpoints do not accept request bodies.
Example
curl "https://api.pepvote.com/voting-events/BOARD26/results/j57position01" \
-H "Authorization: Bearer $PEPVOTE_API_KEY" -H "User-Agent: my-app/1.0"{
"data": {
"id": "j57position01",
"title": "Board chair",
"desc": null,
"groupId": null,
"votingMethod": "plurality",
"tallyRule": {
"type": "plurality_total"
},
"totalCandidates": 2,
"totalVotes": 184,
"totalWeightedVotes": null,
"rankedChoiceCount": null,
"tallyComputedAt": 1777089700000,
"tallyRecountPending": false,
"tallyTrace": null,
"referendum": null,
"candidates": [
{
"id": "j57candidate01",
"name": "Amina Bello",
"status": "approved",
"groupId": null,
"referendumRole": null,
"avatarUrl": null,
"votesWon": 112,
"weightedVotesWon": null,
"percentageWon": 60.87,
"weightedPercentageWon": null
}
]
}
}The all-results response has votingEventId and positions.
Was this helpful?
Last updated September 6, 2026