Skip to main content
GET
/
api
/
chat
/
message
/
detail
Get WhatsApp Message and Conversation Details
curl --request GET \
  --url https://api.automatechats.com/api/chat/message/detail \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.automatechats.com/api/chat/message/detail"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.automatechats.com/api/chat/message/detail', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.automatechats.com/api/chat/message/detail",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.automatechats.com/api/chat/message/detail"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("X-API-Key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.automatechats.com/api/chat/message/detail")
.header("X-API-Key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.automatechats.com/api/chat/message/detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "status": "success",
  "code": 200,
  "message": "Message details retrieved successfully",
  "data": {
    "message": {
      "id": "65f12ab3c9e4f1a2b3c4d5f1",
      "wa_message_id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERg2REI3QzNCRDM2RUQ0RkU3RjAA",
      "direction": "outbound",
      "senderType": "business",
      "senderId": "123456",
      "senderName": "Automate Team",
      "status": "read",
      "message_type": "template",
      "content": {},
      "timestamp": "2026-06-19T14:55:05.000Z",
      "delivered_at": "2026-06-19T14:55:06.000Z",
      "read_at": "2026-06-19T14:55:10.000Z"
    },
    "conversation": {
      "id": "65f12ab3c9e4f1a2b3c4d5f2",
      "recipient_id": "919876543210",
      "phone_number_id": "106294715428491",
      "channel_id": "b340b1b3-bf45-4a61-be71-853a31830dc5",
      "status": "open",
      "priority": "medium",
      "chat_mode": "user"
    }
  },
  "timestamp": "2026-06-19T14:55:15.000Z"
}
{
"status": "error",
"code": 400,
"message": "Invalid input: field first_name is required.",
"error": "<unknown>",
"timestamp": "2026-05-18T15:00:00.000Z"
}
{
"status": "error",
"code": 401,
"message": "Unauthorized access: Invalid or missing authentication credentials.",
"timestamp": "2026-05-18T15:00:00.000Z"
}
{
"status": "error",
"code": 403,
"message": "Access denied. Message does not belong to your workspace.",
"timestamp": "2026-06-19T14:55:15.000Z"
}
{
"status": "error",
"code": 404,
"message": "Message not found",
"timestamp": "2026-06-19T14:55:15.000Z"
}
Use this endpoint to retrieve complete details about a WhatsApp message and its associated conversation. You must provide the unique WhatsApp Message ID as the waMessageId query parameter. This endpoint supports external integrations using your API key.

Workspace isolation and security

To protect your data, this endpoint enforces strict multi-tenancy. You can only fetch messages that belong to your workspace. Access is blocked if the message’s WhatsApp Business Account (WABA) ID does not match your workspace.

API key scoping restrictions

Access is restricted if your API key is scoped to a specific phone number or channel ID. The system checks if the conversation matches the scoped phone number or channel ID. Any scope violation returns a 403 Forbidden response.

Authorizations

X-API-Key
string
header
required

Query Parameters

waMessageId
string
required

The unique WhatsApp Message ID (e.g. wamid.HBgMOTE5ODc2NTQzMjEw...)

Response

Message and conversation details retrieved successfully

status
string
Example:

"success"

code
integer
Example:

200

message
string
Example:

"Message details retrieved successfully"

data
object
timestamp
string<date-time>
Example:

"2026-06-19T14:55:15.000Z"