---
title: "get poll votes"
method: POST
path: "/instances/{id}/client/action/get-poll-votes"
tags: ["message"]
---

# get poll votes

`POST /instances/{id}/client/action/get-poll-votes`

Retrieves the vote information for a specific poll message, including who voted for which options and the original poll message details.

## Path parameters

- `id` integer, required

## Request body

- object
  - `messageId` string, required — Serialized message identifier of the poll message

## Response `200`

Poll votes retrieved successfully

- object
  - `status` string
  - `instanceId` string
  - `data` object
    - `messageId` string — The poll message ID
    - `votes` object[] — Array of vote information for the poll
      - `voter` string — ID of the user who voted
      - `selectedOptions` object[] — Array of selected options
        - `name` string — The text of the selected option
        - `localId` integer — Zero-based index of the selected option
      - `interractedAtTs` integer — Timestamp when the vote was cast (milliseconds)
      - `parentMessage` object — Complete details of the parent poll message
        - `id` object
          - `fromMe` boolean
          - `remote` string
          - `id` string
          - `_serialized` string
        - `ack` integer
        - `body` string
        - `type` string
        - `from` string
        - `to` string
        - `pollName` string
        - `pollOptions` object[]
          - `name` string
          - `localId` integer
        - `allowMultipleAnswers` boolean

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized — invalid or missing bearer token
- `403` — Forbidden — insufficient permissions or account blocked
- `404` — Not Found
- `409` — Conflict — instance is not ready
- `422` — Validation error — invalid or missing request parameters
- `429` — Too many requests — rate limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.net/waapi/apis/waapi-api.md) · [All operations](https://skmtc.net/waapi/apis/waapi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/waapi/waapi-api/revisions/1e2cc7c12090/schema)