---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/messenger/doc/ru/api-requests/poll-get-results.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/messenger/doc/ru/llms.txt

# Получение результатов опроса

Метод позволяет получать результаты опроса пользователей в чате: общее количество проголосовавших и число голосов, отданных за каждый вариант ответа.

HTTP метод: `GET`

URL: `https://botapi.messenger.yandex.net/bot/v1/polls/getResults/`

## Заголовки
```
Authorization: OAuth <токен>
Content-Type: application/json
```

## Тело запроса (JSON или URL Query)
| Имя параметра | Обязательный | Тип       | Описание                                                   | Ограничения, значение по умолчанию |
|---------------|--------------|-----------|------------------------------------------------------------|-----------------------------------|
| `chat_id`     | Нет*         | `string`  | ID группового чата                                         | Бот должен быть участником чата   |
| `login`       | Нет*         | `string`  | Логин пользователя                                         | —                                 |
| `message_id`  | Да           | `integer` | ID сообщения с опросом в чате                              | —                                 |
| `invite_hash` | Нет          | `string`  | Хеш пригласительной ссылки, если бот еще не состоит в чате | —                                 |
| `thread_id`   | Нет          | `integer` | Идентификатор треда (timestamp сообщения)                  | —                                 |

(*) Параметры `chat_id` и `login` являются необязательными, но необходимо заполнить хотя бы один из двух.

## Результат
Результатом успешного запроса является ответ с кодом 200 и телом с JSON, где содержится информация о результатах опроса.

| Имя параметра | Обязательный | Тип                   | Описание                                                                          |
|---------------|--------------|-----------------------|-----------------------------------------------------------------------------------|
| `ok`          | Да           | `boolean`             | Флаг успешности выполнения                                                        |
| `answers`     | Да           | `map from int to int` | Результаты опроса, в формате ключ - номер варианта, значение - количество голосов |
| `voted_count` | Да           | `integer`             | Количество проголосовавших в опросе                                               |

## Пример запроса
```
curl -H 'Authorization: OAuth AtXXXXXXXXXXX' 'https://botapi.messenger.yandex.net/bot/v1/polls/getResults?login=maria&message_id=1647523230504005'
```

## Пример успешного ответа
```
{"ok": true, "voted_count": 5, "answers": {'1': 5, '2': 0}}
```

## Пример ответа с ошибкой
```
{"ok": false, "description": "Bot is not a member of the chat"}
```