Domains

Retrieve an email sender domain

Changed on

Returns the sender domain with its current status and the DNS records to publish, as of the last check.

get/email-domains/{id}

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/email-domains/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The email domain ID.

Response

Successful response.

idstring required
object'email_domain' required
domainstring required

The sending hostname.

status'pending' | 'verified' | 'failed' required

pending until the required DNS records verify, verified once board email sends from this domain, failed when the last check found a problem (see statusReason; publish or fix the records and verify again).

senderNamestring required
senderLocalPartstring required
senderAddressstring required

The From address once the domain is verified.

statusReason'setup_required' | 'dns_verification_failed' nullable required

Why the last check failed, when it did. setup_required: the domain must be set up with the email provider again; call verify, which re-stages it and returns fresh DNS records. dns_verification_failed: the published records do not match yet; check each record’s status, fix them and verify again.

verifiedAtstring nullable required
lastCheckedAtstring nullable required
createdAtstring required

Changes