Skip to content


The method is aimed for downloading incoming and outgoing files. Links to incoming files are transmitted in Incoming messages, and you can also get them using LastIncomingMessages method. You can get links to outgoing files using LastOutgoingMessages method.

Files storage period and, accordingly, the capability to download them is limited by WhatsApp



Параметры запроса#

Параметр Тип Обязательный Описание
chatId string Да Chat id, for example
idMessage string Yes Message Id transmitted in Incoming messages or when sending files using SendFileByUrl, SendFileByUpload methods. This parameter is transmitted as the final part of the url request


File from message

DownloadFile errors#

For a list of errors common to all methods, refer to Common errors section

curl example#

curl --location -g --request POST '{{host}}/waInstance{{idInstance}}/downloadEncFile/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "",
    "idMessage": "A322F800D3F12CD4858CC947DAFB77A2"

Python example#

import requests
import json

url = "{{host}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}"

payload = json.dumps({
  "chatId": "",
  "idMessage": "A322F800D3F12CD4858CC947DAFB77A2"
headers = {
  'Content-Type': 'application/json'

response = requests.request("POST", url, headers=headers, data=payload)