List sender identities

Returns a paginated list of sender identities, optionally filtered by verification status, active state, or default flag.

GET
/v1/email/senders

Returns a paginated list of sender identities, optionally filtered by verification status, active state, or default flag. Each row carries deliverability (bounce and complaint rates over the last 24 hours) and series, the last 14 days of daily email sends from the address, oldest first.

x-api-key<token>

In: header

Query Parameters

page?string|null
limit?string|null
verificationStatus?|null
isActive?string|null
isDefault?string|null

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/email/senders"
{  "items": [    {      "id": "string",      "organizationId": "string",      "email": "string",      "name": "string",      "domainId": "string",      "verificationStatus": "pending",      "verifiedAt": "string",      "verificationToken": "string",      "providerLifecycle": "provisioning",      "providerFailureCode": "string",      "isDefault": true,      "replyToEmails": [        "string"      ],      "deliverability": {        "bounceRate": 0,        "complaintRate": 0,        "windowSends": 0,        "sendingStatus": "enabled"      },      "series": [        0      ],      "isActive": true,      "createdAt": "string",      "updatedAt": "string"    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}

Related