Skip to main content
GET
/
api
/
chat
/
getMessage
/
:instance
Find message by ID
curl --request GET \
  --url https://api.example.com/api/chat/getMessage/:instance
Auth: TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: yes

​
Description

Returns the persisted snapshot of a message (text, media, caption, mimetype, size, etc.) that has already been processed by ingestion. Useful to rehydrate a message from the messageId received in a webhook or in another API endpoint.

​
Examples

​
By id

Retrieves the message snapshot using the ?messageId=<message-id> query. Returns the full record (text, media, caption, mimetype, size) persisted by ingestion. 
curl -X GET "https://ryzeapi.cloud/api/chat/getMessage/$Instance_Name?messageId=3EB08FCF27E532F1B0F5" \
  -H "token: $Token_Instance"

​
Success response

The snapshot comes in data with type, from, to, chat, timestamp, isGroup, and the send status. For text messages, content carries the body; for media, the media object appears with type, mimeType, size, and duration (audio/video). Use messageId from the envelope to reference this message in subsequent calls (favorite, forward, edit).
200 OK
{
  "success": true,
  "message": "Message found",
  "messageId": "3EB08FCF27E532F1B0F5",
  "data": {
    "content": "Hi!",
    "type": "text",
    "from": "5511999999999@s.whatsapp.net",
    "to": "5511888888888@s.whatsapp.net",
    "chat": "5511999999999@s.whatsapp.net",
    "timestamp": "2026-04-28T14:30:00Z",
    "isGroup": false,
    "status": "delivered"
  },
  "status": "found"
}

​
Path parameters

​
instance
string
required
Instance name.

​
Query params

​
messageId
string
required
Message ID (required).

​
Headers

NameRequiredExampleDescription
tokenyes (or Authorization)a1b2c3d4-...TokenAccount or TokenInstance.

​
Error responses

HTTPerror.messageWhen it happens
400Message ID is required (use ?messageId=<message-id>)Missing messageId.
404Instance not found,
404Message not foundID does not exist in the database.
503Instance is not connected to WhatsApp,
Error 400
{
  "success": false,
  "error": { "message": "Message ID is required (use ?messageId=<message-id>)" }
}

Media as base64

Retrieve raw media from the messageId.

Delivery status

Check whether it was delivered/read.