Skip to content


The method is aimed for getting a list of messages in the queue to be sent. Messages sending rate is managed by Messages sending delay parameter.


To get a messages queue, you have to execute a request at:


For idInstance and apiTokenInstance request parameters, refer to Before you start section.


Response parameters#

Array of objects with parameters:

Parameter Type Description
typeMessage string Message type, possible variants:
textMessage - text message
imageMessage - image message
videoMessage - video message
documentMessage - document file message
audioMessage - audio message
locationMessage - location message
contactMessage - contact message
extendedTextMessage - link and preview message
chatId string Chat Id where the message will be sent to
message string message text, if typeMessage = textMessage/locationMessage/contactMessage/extendedTextMessage
fileName string outgoing file name, if typeMessage = imageMessage/videoMessage/documentMessage/audioMessage

Response body example#

        "typeMessage": "textMessage",
        "chatId": "",
        "message": "I use Green-API to send this message to you!"
        "typeMessage": "imageMessage",
        "chatId": "",
        "fileName": "image.jpg"

ShowMessagesQueue errors#

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

Python request example#

import requests

url = "{{idInstance}}/showMessagesQueue/{{apiTokenInstance}}"

payload = {}
headers= {}

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