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

# Получение файла

Метод позволяет получать файлы, которые были отправлены в чаты.

HTTP метод: `GET` или `POST`

URL: `https://botapi.messenger.yandex.net/bot/v1/messages/getFile/`

## Заголовки
```
Authorization: OAuth <токен>
Content-Type: application/json (только для POST-запросов)
```

## Тело запроса
| Имя параметра | Обязательный | Тип       | Описание                                | Ограничения, значение по умолчанию |
| ------------- | ------------ | --------- | --------------------------------------- | ---------------------------------- |
| `file_id`     | Да           | `string`  | ID файла                                | —                                  |

## Результат
В результате успешного запроса будет открыт поток для отправки запрошенного файла.

## Пример запроса
```sh
curl -H 'Authorization: OAuth AtXXXXXXXXXXX' \
     -F file_id='<file_id>' \
     'https://botapi.messenger.yandex.net/bot/v1/messages/getFile'
```

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