Skip to main content
GET
/
email
/
sending-identities
List identities
curl --request GET \
  --url https://www.dench.com/api/v1/email/sending-identities \
  --header 'Authorization: Bearer <token>'
[
  {
    "identityId": "esi_abc123",
    "type": "email",
    "fromEmail": "founder@example.com",
    "fromName": "Ada at Example",
    "deliveryVerificationStatus": "verified",
    "denchVerificationStatus": "verified",
    "disabled": false,
    "createdAt": 1765526400000
  }
]

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

​
domain
string

Filter identities by domain.

Response

Successful response

​
identityId
string
required
​
type
enum<string>
required

Identity scope. domain verifies via DNS (DKIM); email verifies a single mailbox via a confirmation email.

Available options:
domain,
email
​
fromEmail
string
required
​
deliveryVerificationStatus
enum<string>
required

Provider-side (DNS/mailbox) verification status.

Available options:
pending,
verified,
failed,
disabled
​
denchVerificationStatus
enum<string>
required

Workspace-side sender verification status.

Available options:
pending,
verified,
expired,
disabled
​
disabled
boolean
required
​
createdAt
number
required
​
domain
string
​
fromName
string
​
disabledAt
number