For AI agents: markdown of this page — /docs-content-en/polls/voters.md documentation index — /llms.txt

List voters for an answer

GET /v1/polls/:pollId/answers/:answerId/voters

Returns users who selected a specific answer, in pages of 50. Bitrix24 controls visibility; nobody can see voter identities in an anonymous poll.

The poll is read first to check result visibility under Bitrix24 rules. When resultsVisible: false, the API returns 403 RESULTS_HIDDEN without requesting voters. This read subscribes the user to events, so a Cowork key with read-only access to the Bitrix24 account receives 403 COWORK_READONLY before any call to Bitrix24.

Scope: vote. Key restrictions: Polls.

Parameters

Parameter Type Required Default Description
ParameterpollId (path) Typenumber Requiredyes Default— DescriptionPositive attachment ID: the id field from poll discovery, rather than voteId
ParameteranswerId (path) Typenumber Requiredyes Default— DescriptionPositive ID from questions[].answers[].id in the poll
Parameterpage (query) Typenumber Requiredno Default1 DescriptionPositive integer. Fixed page size: 50 voters

Examples

curl — personal key

Terminal 
curl "https://vibecode.bitrix24.com/v1/polls/7/answers/22/voters?page=1" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl "https://vibecode.bitrix24.com/v1/polls/7/answers/22/voters?page=1" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/polls/7/answers/22/voters?page=1', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const result = await res.json()

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/polls/7/answers/22/voters?page=1', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const result = await res.json()

Response fields

Field Type Description
Fieldsuccess Typeboolean Descriptiontrue on success
Fielddata Typearray DescriptionVoters for the selected answer
Fielddata[].id Typenumber DescriptionUser ID
Fielddata[].name Typestring DescriptionName
Fielddata[].position Typestring | null DescriptionPosition
Fielddata[].avatarUrl Typestring | null DescriptionAvatar URL
Fieldmeta.page Typenumber DescriptionCurrent page
Fieldmeta.pageSize Typenumber Description50
Fieldmeta.total Typenumber DescriptionTotal supplied by Bitrix24
Fieldmeta.nextPage Typenumber | null DescriptionNext page; null at the end

Response example

Illustrative response based on the normalizer and test fixtures; not a live Bitrix24 response.

JSON 
{
  "success": true,
  "data": [
    {
      "id": 9,
      "name": "Ada",
      "position": "Engineer",
      "avatarUrl": null
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 50,
    "total": 51,
    "nextPage": 2
  }
}

Errors

HTTP Code Cause and action
HTTP400 CodeINVALID_PARAMS Cause and actionInvalid ID or request parameter
HTTP401 CodeTOKEN_MISSING Cause and actionNo Bitrix24 user session
HTTP403 CodeSCOPE_DENIED Cause and actionRequired scope is missing
HTTP403 CodeRESULTS_HIDDEN Cause and actionResults hidden under Bitrix24 rules
HTTP403 CodePOLL_ACCESS_DENIED Cause and actionBitrix24 denied reading the poll during the result visibility check
HTTP403 CodeCOWORK_READONLY Cause and actionOperation forbidden for a Cowork portal-readonly key
HTTP404 CodePOLL_NOT_FOUND Cause and actionPoll missing or inaccessible
HTTP404 CodeANSWER_NOT_FOUND Cause and actionAnswer missing or its voter list is inaccessible
HTTP422 CodeBITRIX_ERROR Cause and actionBitrix24 rejected the request, for example because the method is unavailable in this version

Other authentication refusals, limits and shared errors: error codes.

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid poll parameters."
  }
}