Blueticks
Messages

Get message media

Download the media attached to a WhatsApp message (image, video, document, audio).

Returns either a hosted URL (url) or inline data_base64, plus mimetype + filename.

CAVEAT: for own-sent newsletter media (messages you sent to a @newsletter chat), the bytes returned are a WA-generated preview JPEG (~7KB) rather than the original you uploaded — WA releases the original blob from memory immediately after the unencrypted upload. The response will include original_quality:false when this fallback is in effect; the caller can warn the user or decide to retry from a different source.

Requires chats:read.

Request

curl -X GET "https://api.blueticks.co/v1/messages/media/string"
GET
/v1/messages/media/{waMessageKey}

Path Parameters

waMessageKey*string

The complete WhatsApp message key (<fromMe>_<chatJid>_<id>[_<participant>]), e.g. false_120363426216988013@g.us_3EB0659D13650092D677AD_188450464616609@lid.

Query Parameters

chatId?string

Optional. Only used to find the message faster — when you pass a bare message id instead of the complete key, chatId lets the server rebuild the full key. If you pass the complete waMessageKey you can omit it.

Response

Response Body

application/json

application/json