Skip to main content
GET
/
email
/
campaigns
/
{campaignId}
Campaign status
curl --request GET \
  --url https://www.dench.com/api/v1/email/campaigns/{campaignId} \
  --header 'Authorization: Bearer <token>'
{
  "_id": "ecmp_abc123",
  "_creationTime": 1765526395000,
  "organizationId": "org_abc123",
  "name": "Q2 outreach",
  "status": "sending",
  "sendingIdentityId": "esi_abc123",
  "templateId": "etpl_abc123",
  "subjectSnapshot": "Hi {{firstName}}",
  "htmlSnapshot": "<p>Hi {{firstName}}, saw your work at {{company}}.</p>",
  "fromEmailSnapshot": "founder@example.com",
  "createdBy": "user:us_xyz789",
  "totalRecipients": 120,
  "queuedCount": 70,
  "sendingCount": 0,
  "sentCount": 50,
  "deliveredCount": 48,
  "openedCount": 12,
  "clickedCount": 3,
  "bouncedCount": 1,
  "complainedCount": 0,
  "failedCount": 0,
  "suppressedCount": 2,
  "unsubscribedCount": 0,
  "maxRecipients": 0,
  "batchSize": 50,
  "createdAt": 1765526395000,
  "updatedAt": 1765526460000
}

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

campaignId
string
required

Response

Successful response

The full campaign document with counters.

_id
string
required
_creationTime
number
required
organizationId
string
required
name
string
required
status
enum<string>
required

Campaign lifecycle status.

Available options:
draft,
pending_approval,
scheduled,
sending,
paused,
completed,
cancelled,
failed
sendingIdentityId
string
required
templateId
string
required
subjectSnapshot
string
required
htmlSnapshot
string
required
fromEmailSnapshot
string
required
createdBy
string
required
totalRecipients
number
required
queuedCount
number
required
sendingCount
number
required
sentCount
number
required
deliveredCount
number
required
openedCount
number
required
clickedCount
number
required
bouncedCount
number
required
complainedCount
number
required
failedCount
number
required
suppressedCount
number
required
unsubscribedCount
number
required
maxRecipients
number
required
batchSize
number
required
createdAt
number
required
updatedAt
number
required
textSnapshot
string
fromNameSnapshot
string
replyToEmailSnapshot
string
scheduledAt
number
submittedAt
number
startedAt
number
completedAt
number
cancelledAt
number
lastError
string
{key}
any