GET
/
webhook
/
mail
/
status?message_id=
{message_id}
cURL
curl --request GET \
  --url 'https://webhook.cocoonmail.com/webhook/mail/status?message_id={message_id}' \
  --header 'Authorization: Bearer <token>'
{
  "message": "Mail status data fetched successfully",
  "data": {
    "x_message_id": "123e4567-e89b-12d3-a456-426614174000",
    "mail_content": "<p>Hello John, welcome to our platform!</p>",
    "subject": "Welcome to Our Platform",
    "name": "John Doe",
    "sent": true,
    "sent_at": "2026-03-20T10:15:30.000Z",
    "bounced": false,
    "bounced_at": null,
    "bounced_error": null,
    "unsubscribed": false,
    "unsubscribed_at": null,
    "delivered": true,
    "delivered_at": "2026-03-20T10:16:05.000Z",
    "open": true,
    "opened_count": 3,
    "bounce_type": null,
    "clicked": true,
    "clicked_count": 2,
    "sendable": true,
    "failed": false,
    "SMTP_code": "250",
    "SMTP_error": null,
    "email": "john.doe@example.com",
    "transactional_mail_id": "trns-abc123xyz789",
    "created": "2026-03-20T10:14:50.000Z",
    "transactional_name": "Welcome Email Campaign",
    "scheduled_at": "2026-03-20T10:15:00.000Z",
    "tracking_logs": [
      {
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/122.0.0.0 Safari/537.36",
        "client_family": "Chrome",
        "client_version": "122.0.0.0",
        "os_name": "Windows",
        "os_version": "10",
        "device_type": "Desktop",
        "ip_address": "192.168.1.1",
        "created": "2026-03-20T10:17:10.000Z",
        "type": "OPEN"
      },
      {
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 Version/17.0 Mobile Safari/604.1",
        "client_family": "Mobile Safari",
        "client_version": "17.0",
        "os_name": "iOS",
        "os_version": "17.0",
        "device_type": "Mobile",
        "ip_address": "192.168.1.2",
        "created": "2026-03-20T10:18:25.000Z",
        "type": "CLICK"
      }
    ]
  }
}

Email Status

Use this endpoint to check the delivery status of a specific email message.

Parameters

NameInRequiredDescription
message_idqueryYesUnique identifier of the email

Response fields

Status CodeDescription
200Successful retrieval of email status
400Bad request (invalid message_id format)
401Authentication required
500Internal server error
{
  "message": "Mail status data fetched successfully",
  "data": {
    "x_message_id": "123e4567-e89b-12d3-a456-426614174000",
    "mail_content": "<p>Hello John, welcome to our platform!</p>",
    "subject": "Welcome to Our Platform",
    "name": "John Doe",
    "sent": true,
    "sent_at": "2026-03-20T10:15:30.000Z",
    "bounced": false,
    "bounced_at": null,
    "bounced_error": null,
    "unsubscribed": false,
    "unsubscribed_at": null,
    "delivered": true,
    "delivered_at": "2026-03-20T10:16:05.000Z",
    "open": true,
    "opened_count": 3,
    "bounce_type": null,
    "clicked": true,
    "clicked_count": 2,
    "sendable": true,
    "failed": false,
    "SMTP_code": "250",
    "SMTP_error": null,
    "email": "john.doe@example.com",
    "transactional_mail_id": "trns-abc123xyz789",
    "created": "2026-03-20T10:14:50.000Z",
    "transactional_name": "Welcome Email Campaign",
    "scheduled_at": "2026-03-20T10:15:00.000Z",
    "tracking_logs": [
      {
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/122.0.0.0 Safari/537.36",
        "client_family": "Chrome",
        "client_version": "122.0.0.0",
        "os_name": "Windows",
        "os_version": "10",
        "device_type": "Desktop",
        "ip_address": "192.168.1.1",
        "created": "2026-03-20T10:17:10.000Z",
        "type": "OPEN"
      },
      {
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 Version/17.0 Mobile Safari/604.1",
        "client_family": "Mobile Safari",
        "client_version": "17.0",
        "os_name": "iOS",
        "os_version": "17.0",
        "device_type": "Mobile",
        "ip_address": "192.168.1.2",
        "created": "2026-03-20T10:18:25.000Z",
        "type": "CLICK"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Use your API key with the 'Bearer ' prefix

Path Parameters

message_id
string<uuid>
required

Response

200

No response body