Skip to main content
GET
/
api
/
v1
/
meta-templates
/
messages
/
{message_id}
/
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/messages/wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=/" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "id": 123,
  "template": {
    "id": 45,
    "name": "welcome_message",
    "language": "es",
    "category": "MARKETING"
  },
  "recipient": {
    "phone": "+5491112345678",
    "contact_name": "Juan Perez",
    "contact_id": 789
  },
  "variables_used": {
    "name": "Juan Perez",
    "code": "ABC123"
  },
  "delivery_status": {
    "current": "read",
    "sent_at": "2025-11-16T21:30:00Z",
    "delivered_at": "2025-11-16T21:30:05Z",
    "read_at": "2025-11-16T21:31:00Z",
    "failed_at": null,
    "error_code": null,
    "error_message": null
  },
  "meta_message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "was_successful": true,
  "error_message": null,
  "sent_at": "2025-11-16T21:30:00Z"
}

​
Description

This endpoint returns the updated status of an individual message sent with a WhatsApp template. It complements the fire-and-forget pattern of Send message: you use the message_id (wamid) returned when sending to check the message’s current delivery status. Delivery statuses (sent, delivered, read, failed) are updated automatically as Meta sends the corresponding webhooks. A message just sent will typically show sent until the delivery and read confirmations arrive.

​
Authentication header

​
X-API-Key
string
required
Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Path parameters

​
message_id
string
required
Message ID assigned by Meta (wamid). It’s the message_id value returned by Send message when sending the template.

​
Response (200 OK)

​
id
integer
Internal ID of the send record in Mindo.
​
template
object
Information about the template used.
​
recipient
object
Recipient information.
​
variables_used
object
Variables used to render the template for this send.
​
delivery_status
object
Detailed delivery status with the timestamp of each transition. Updated via Meta webhooks.
​
meta_message_id
string | null
Message ID in Meta (wamid). Matches the message_id in the path.
​
was_successful
boolean
Whether the initial send to Meta was successful.
​
error_message
string | null
Error message from the initial send. null if there was no error.
​
sent_at
string (ISO 8601)
Date and time the send was recorded.
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/messages/wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=/" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "id": 123,
  "template": {
    "id": 45,
    "name": "welcome_message",
    "language": "es",
    "category": "MARKETING"
  },
  "recipient": {
    "phone": "+5491112345678",
    "contact_name": "Juan Perez",
    "contact_id": 789
  },
  "variables_used": {
    "name": "Juan Perez",
    "code": "ABC123"
  },
  "delivery_status": {
    "current": "read",
    "sent_at": "2025-11-16T21:30:00Z",
    "delivered_at": "2025-11-16T21:30:05Z",
    "read_at": "2025-11-16T21:31:00Z",
    "failed_at": null,
    "error_code": null,
    "error_message": null
  },
  "meta_message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "was_successful": true,
  "error_message": null,
  "sent_at": "2025-11-16T21:30:00Z"
}

​
Message statuses

The delivery_status.current field can have the following values:
StatusDescription
sentMessage successfully sent to Meta
deliveredMessage delivered to the recipient’s device
readMessage read by the recipient
failedMessage send failed
Statuses update automatically as Meta sends the delivery and read webhooks. If you query immediately after sending, it’s normal to see the sent status until the confirmations arrive.