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

# Получение информации о боте

Метод позволяет получить основную информацию о текущем боте: его идентификатор, логин, отображаемое имя, описание и URL вебхука.

HTTP метод: `GET`

URL: `https://botapi.messenger.yandex.net/bot/v1/self/get`

## Заголовки
```
Authorization: OAuth <токен>
```

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

| Имя параметра  | Обязательный | Тип            | Описание                                            |
|----------------|--------------|----------------|-----------------------------------------------------|
| `ok`           | Да           | `boolean`      | Флаг успешности выполнения                          |
| `id`           | Да           | `string`       | Идентификатор бота                                  |
| `login`        | Да           | `string`       | Логин бота                                          |
| `display_name` | Нет          | `string`       | Отображаемое имя бота                               |
| `webhook_url`  | Нет          | `string`       | URL для получения обновлений через webhook           |
| `organizations`| Нет          | `integer[]`    | Список идентификаторов организаций, к которым подключен бот |
| `settings`     | Нет          | `object`       | Настройки бота. Для внешнего Bot API доступны флаги `get_reactions` и `get_members_changed` |

В случае ошибки возвращается соответствующий статус HTTP. Описание ошибки приходит в поле `description`.

| Имя параметра | Обязательный | Тип       | Описание                   |
|---------------|--------------|-----------|----------------------------|
| `ok`          | Да           | `boolean` | Флаг успешности выполнения |
| `description` | Да           | `string`  | Описание ошибки            |

## Пример запроса
```
curl -H 'Authorization: OAuth AtXXXXXXXXXXX' 'https://botapi.messenger.yandex.net/bot/v1/self/get'
```

## Пример успешного ответа
```json
{
  "ok": true,
  "id": "6d8d04f7-31f7-4030-8926-305587256f0e",
  "login": "my-bot",
  "display_name": "My Bot",
  "webhook_url": "https://example.com/webhook",
  "settings": {
    "get_reactions": true,
    "get_members_changed": false
  }
}
```

## Пример ответа с ошибкой
```json
{"ok": false, "description": "Unauthorized"}
```