Message status

curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/messages/wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=/" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

message_id = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA="

response = requests.get(
    f"https://api.mindosoftware.com/api/v1/meta-templates/messages/{message_id}/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()
print(f"Current status: {data['delivery_status']['current']}")
print(f"Delivered: {data['delivery_status']['delivered_at']}")
print(f"Read: {data['delivery_status']['read_at']}")

const messageId = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=";

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/messages/${encodeURIComponent(messageId)}/`,
  {
    method: "GET",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log("Current status:", data.delivery_status.current);
console.log("Delivered:", data.delivery_status.delivered_at);
console.log("Read:", data.delivery_status.read_at);

{
  "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"
}

{
  "error": "Mensaje no encontrado"
}

{
  "error": "No tienes acceso a este mensaje"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

GET

api

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"

import requests

message_id = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA="

response = requests.get(
    f"https://api.mindosoftware.com/api/v1/meta-templates/messages/{message_id}/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()
print(f"Current status: {data['delivery_status']['current']}")
print(f"Delivered: {data['delivery_status']['delivered_at']}")
print(f"Read: {data['delivery_status']['read_at']}")

const messageId = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=";

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/messages/${encodeURIComponent(messageId)}/`,
  {
    method: "GET",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log("Current status:", data.delivery_status.current);
console.log("Delivered:", data.delivery_status.delivered_at);
console.log("Read:", data.delivery_status.read_at);

{
  "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"
}

{
  "error": "Mensaje no encontrado"
}

{
  "error": "No tienes acceso a este mensaje"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

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

string

required

Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Path parameters

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)

integer

Internal ID of the send record in Mindo.

object

Information about the template used.

Show template properties

integer

Internal template ID.

string

Template name.

string

Template language (e.g.: "es", "en", "pt_BR").

string

Template category in Meta (e.g.: "MARKETING", "UTILITY", "AUTHENTICATION").

object

Recipient information.

Show recipient properties

string

Recipient’s phone number.

string | null

Contact name in Mindo. null if the phone number doesn’t match a registered contact.

integer | null

Contact ID in Mindo. null if the phone number doesn’t match a registered contact.

object

Variables used to render the template for this send.

object

Detailed delivery status with the timestamp of each transition. Updated via Meta webhooks.

Show delivery_status properties

string

Current message status. See status table.

string (ISO 8601) | null

Date and time the message was sent to Meta.

string (ISO 8601) | null

Date and time of delivery to the device. null if not yet delivered.

string (ISO 8601) | null

Date and time of read. null if not yet read.

string (ISO 8601) | null

Date and time the send failed. null if it didn’t fail.

string | null

Meta error code if the message failed. null if there was no error.

string | null

Error description if the message failed. null if there was no error.

string | null

Message ID in Meta (wamid). Matches the message_id in the path.

boolean

Whether the initial send to Meta was successful.

string | null

Error message from the initial send. null if there was no error.

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"

import requests

message_id = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA="

response = requests.get(
    f"https://api.mindosoftware.com/api/v1/meta-templates/messages/{message_id}/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()
print(f"Current status: {data['delivery_status']['current']}")
print(f"Delivered: {data['delivery_status']['delivered_at']}")
print(f"Read: {data['delivery_status']['read_at']}")

const messageId = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=";

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/messages/${encodeURIComponent(messageId)}/`,
  {
    method: "GET",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log("Current status:", data.delivery_status.current);
console.log("Delivered:", data.delivery_status.delivered_at);
console.log("Read:", data.delivery_status.read_at);

{
  "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"
}

{
  "error": "Mensaje no encontrado"
}

{
  "error": "No tienes acceso a este mensaje"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Message statuses

The delivery_status.current field can have the following values:

Status	Description
`sent`	Message successfully sent to Meta
`delivered`	Message delivered to the recipient’s device
`read`	Message read by the recipient
`failed`	Message 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.

Get started

Business accounts

Business info

Messages

Contacts

Bulk sending

Qualitative export

Description

Authentication header

Path parameters

Response (200 OK)

Message statuses

​Description

​Authentication header

​Path parameters

​Response (200 OK)

​Message statuses

Description

Authentication header

Path parameters

Response (200 OK)

Message statuses