Skip to main content
GET
/
email
/
messages
/
{messageId}
Message status
curl --request GET \
  --url https://www.dench.com/api/v1/email/messages/{messageId} \
  --header 'Authorization: Bearer <token>'
{
  "messageId": "emsg_abc123",
  "status": "opened",
  "fromEmail": "founder@example.com",
  "to": [
    {
      "email": "ada@lovelace.dev",
      "name": "Ada"
    }
  ],
  "subject": "Quick intro",
  "providerMessageId": "0100018abc-provider-id",
  "rfcMessageId": "<0100018abc@email.amazonses.com>",
  "recipientCount": 1,
  "openCount": 2,
  "clickCount": 1,
  "sentAt": 1765526400000,
  "deliveredAt": 1765526410000,
  "firstOpenedAt": 1765529700000,
  "createdAt": 1765526395000
}

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Path Parameters

messageId
string
required

Raw email message id.

Response

Successful response

A raw email message with delivery + engagement counters.

messageId
string
required
status
enum<string>
required

Raw email message lifecycle status.

Available options:
queued,
sent,
failed,
delivered,
opened,
clicked,
bounced,
complained
fromEmail
string
required
to
object[]
required
subject
string
required
recipientCount
number
required
openCount
number
required
clickCount
number
required
createdAt
number
required
fromName
string
cc
object[]
bcc
object[]
inReplyTo
string
references
string[]
providerMessageId
string
rfcMessageId
string
sentAt
number
deliveredAt
number
firstOpenedAt
number
lastOpenedAt
number
firstClickedAt
number
bouncedAt
number
complainedAt
number
lastError
string