---
title: "Get info on all polls in a meeting, or only to those within a given submodule."
method: GET
path: "/v1/meetings/{meetingId}/polls"
tags: ["Polls"]
---

# Get info on all polls in a meeting, or only to those within a given submodule.

`GET /v1/meetings/{meetingId}/polls`

## Request

- Base URL: `https://app.meet.ps/api`
- URL: `https://app.meet.ps/api/v1/meetings/{meetingId}/polls`
- Auth: HTTP bearer

Returns an array (list) of meeting polls with their properties and aggregated results.

The amount of voting data detalization depends on the credentials of the user doing the request.
Users who have meeting control roles have elevated privileges and receive per-user vote information.
This data gets be served in CSV format by default.

**Meeting role** required for detailed voting data: *owner*, *presenter*, *polls-manager* or *auditor*.

Otherwise, a meeting participant role is required to get the data set that would only contain aggregate results.
This mode does not support CSV output.

## Path parameters

- `meetingId` string, required: A canonical meeting ID string that's generated automatically for new meetings. Normally consists of just alphanumericals; legacy meetings can have dashes and underscores.

## Query parameters

- `phase` integer

## Response `200`

A list of polls together with aggregate and per-user vote data

- object
  - `result` union[]
    - union
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `binaryCheckbox` boolean: Whether to prefer the checkbox UI when showing this poll.
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `answers` string[]
        - `max` unknown
        - `confidence` unknown
        - `confidenceLabels` unknown[]: Defines custom confidence levels if running a quiz poll with confidence data collection. *
          - unknown
        - `quiz` boolean
        - `valid` unknown[]
          - unknown
        - `hideValid` boolean
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `placeholder` unknown
        - `prefix` string: Readable prefix for the value of the poll
        - `min` unknown
        - `max` unknown
        - `confidence` unknown
        - `confidenceLabels` unknown[]: Defines custom confidence levels if running a quiz poll with confidence data collection. *
          - unknown
        - `quiz` boolean: Whether the poll is a quiz that has a valid answer defined via the "valid" field
        - `valid` unknown
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `placeholder` unknown
        - `short` unknown
        - `singleWord` unknown
        - `phrase` unknown
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `answers` string[]: Available answers to sort
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `answers` string[]
        - `min` integer: Minimum score available to rate every item
        - `max` integer: Maximum score available to rate every item. Note that min and max values cannot be equal, but can be swapped around for a reverse order of a rating scale.
        - `legend` string[]: Optional labels associated with any of the eleven range numbers, from zero to eleven.
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `min` integer: Minimum score available to cast
        - `max` integer: Maximum score available to cast. Note that min and max values cannot be equal, but can be swapped around for a reverse order of a rating scale.
        - `legend` string[]: Optional labels associated with any of the eleven range numbers, from zero to eleven.
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object
      - object: Data on aggregate and per-user votes for a poll
        - `id` string
        - `type` 'binary' | 'divider' | 'divider-image' | 'group' | 'nps' | 'numeric' | 'open' | 'ordered' | 'rated' | 'rated-multiple' | 'rcv' | 'reg-text-company' | 'reg-text-free' | 'reg-text-title' | 'reg-text-url' | 'reg-text-linkedin' | 'reg-text-bio' | 'reg-text-scheduling-link' | 'reg-text-interests' | 'reg-profile-photo' | 'reg-file' | 'voted'
        - `question` string
        - `parent` string
        - `phase` unknown
        - `state` 'ready' | 'live'
        - `order` integer
        - `created` integer
        - `revote` boolean
        - `renderer` string: Visualization preference to use in Report or Broadcast view
        - `rendererOptions` object
          - `pageSize` unknown
          - `reportPageCount` unknown
        - `hideResults` boolean: Whether poll results are to be shown to a participant after they cast their vote.
        - `sortByVote` boolean: Preferred way to draw series in the chart - sort descending if true, initial sort otherwise
        - `choicesDisplayType` string: A preference for a specific poll UI layout.
        - `totalValueType` 'percent' | 'totalCount': Preferred format of totals in the chart series - percents or absolute number of votes/score
        - `comparisonView` boolean: Whether the poll is to be shown in the Comparison Broadcast view, if supported
        - `broadcast` boolean: Whether the poll shows in various Broadcast views, as long as they support the poll type in question
        - `footer` string: Custom poll footer information to be shown below the UI element in case compliance requires it
        - `requires` string: Conditional poll requirement string (<poll-id>/<answer-idx-min>[/<answer-idx-max>]
        - `countdown` integer: Time in seconds you get before the poll locks and no longer accepts new votes
        - `answers` string[]
        - `confidence` unknown
        - `confidenceLabels` unknown[]: Defines custom confidence levels if running a quiz poll with confidence data collection.
          - unknown
        - `quiz` boolean
        - `valid` unknown[]
          - unknown
        - `hideValid` boolean
        - `results` object
        - `fractions` object
        - `percents` object
        - `votes` object
        - `langs` object
        - `originals` object
        - `timestamps` object
        - `winners` object

## Other responses

- `404`: Reference meeting not found

---

[API](https://skmtc.dev/meet/apis/meetingpulse-api.md) · [All operations](https://skmtc.dev/meet/apis/meetingpulse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meet/apis/meetingpulse-api/revisions/dc29466adc0e?raw)