List domains
Returns all custom sending domains in your workspace. Requires domains:manage scope.
Authorization
bearerAuth Bearer token authentication. Use a Regular API key for email sending, or an Admin API key for marketing and automation endpoints.
Get your API keys from Settings → API Keys (regular) or Settings → Admin API Keys (admin) in the dashboard.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://api.keplars.com/api/v1/public/domains/get-domains"{
"success": true,
"message": "Success",
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"domain": "string",
"verification_status": "pending",
"mail_from_status": "string",
"region": "us-east-1",
"verified_at": "2019-08-24T14:15:22Z",
"dns_records": [
{
"type": "TXT",
"name": "keplars._domainkey.example.com",
"value": "string",
"priority": 0
}
],
"registrar_name": "string",
"registrar_iana_id": "string",
"dns_provider": "string",
"registrar_last_checked_at": "2019-08-24T14:15:22Z"
}
]
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}Get domain status GET
Returns the current verification state of a domain. Poll this after `POST /api/v1/public/domains/add-domain` until `verification_status` is `verified`. Requires `domains:manage` scope.
Trigger domain verification POST
Manually triggers a DNS verification check for the domain. Useful for polling after DNS records have been added. Returns the updated verification status. Requires `domains:manage` scope.