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.

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,        "sendingStatus": "enabled"      },      "isActive": true,      "createdAt": "string",      "updatedAt": "string"    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}