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


POST {{APIUrl}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}

Request parameters#

Parameter Type Mandatory Description
chatId string Yes 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

Примеры кода#

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)

curl --location -g --request POST '{{host}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "",
    "idMessage": "A322F800D3F12CD4858CC947DAFB77A2"
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();

var headers = new HttpHeaders();

var jsonBody = "{\"chatId\": \"\",\"idMessage\": \"A322F800D3F12CD4858CC947DAFB77A2\"}";

var requestEntity = new HttpEntity<>(jsonBody, headers);

var response =, HttpMethod.POST, requestEntity, String.class);
var requestUrl = new StringBuilder();

var response =
    .header("Content-Type", "application/json")
    .body("{\"chatId\": \"\",\"idMessage\": \"A322F800D3F12CD4858CC947DAFB77A2\"}")

Sub DownloadFile()
    Dim url As String
    Dim RequestBody As String
    Dim http As Object
    Dim response As String

    ' The idInstance and apiTokenInstance values are available in your account, double brackets must be removed
    url = "{{APIUrl}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}"

    ' chatId - personal or group chat identifier whose message history you want to receive, count - number of messages to receive, default value 100
    RequestBody = "{""chatId"":"""",""idMessage"":""E5A2563784F535FD43B3B83142E1234E""}"

    Set http = CreateObject("MSXML2.XMLHTTP")

    With http
        .Open "POST", url, False
        .setRequestHeader "Content-Type", "application/json"
        .send RequestBody
    End With

    response = http.responseText

    Debug.Print response

    ' Outputting the answer to the desired cell
    Range("A1").Value = response

    Set http = Nothing
End Sub