Get Domain
Fetch one sending domain by id or hostname.
MethodGET
/api/v2/domains/:domainReturns one sending domain. :domain is a MailDomain id or hostname. The body is the domain object — not the hostname string. Permission: domains.
Path Parameters
| Name | Type | Description |
|---|---|---|
domain | string | Required. MailDomain id or hostname. |
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | MailDomain id. |
domain | string | Hostname. |
status | string | NOT_STARTED, PENDING, VERIFIED, or FAILED. |
region | string | AWS region. |
createdAt | string | ISO 8601 created timestamp. |
sesRecords | array | Stored SES DNS records when present. |
dnsRecords | array | Current DNS records: type, name, value, priority, ttl, purpose. |
message | string | Status copy when verification is incomplete. |
Errors
| Status | name | When |
|---|---|---|
| 401 | missing_api_key | Missing or invalid bearer token |
| 403 | missing_permission | Token lacks the domains permission |
| 404 | not_found | Unknown id or hostname |