Skip to main content
GET
/
email
/
messages
List messages
curl --request GET \
  --url https://www.dench.com/api/v1/email/messages \
  --header 'Authorization: Bearer <token>'
[
  {
    "messageId": "emsg_abc123",
    "status": "sent",
    "fromEmail": "founder@example.com",
    "to": [
      {
        "email": "ada@lovelace.dev"
      }
    ],
    "subject": "Quick intro",
    "recipientCount": 1,
    "openCount": 0,
    "clickCount": 0,
    "sentAt": 1765526400000,
    "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.

Query Parameters

limit
integer
Required range: 1 <= x <= 100
status
enum<string>

Raw email message lifecycle status.

Available options:
queued,
sent,
failed,
delivered,
opened,
clicked,
bounced,
complained

Response

Successful response

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