Domains

Retrieve a domain

Retrieve a single sending domain by id, including its current verification status and the DNS records you need to publish. Re-run the DNS check with Verify a domain, or change its tracking/TLS settings with Update a domain. Requires the domains:read capability.

get/email/domains/{id}

Request

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

Response

The domain.

object'domain' required
idstring required
namestring required
status'pending' | 'verifying' | 'verified' | 'degraded' | 'failed' required
dkim_selectorstring nullable required
open_trackingboolean nullable required
click_trackingboolean nullable required
tls'opportunistic' | 'enforced' required
tracking_subdomainstring nullable required
tracking_verified_atstring nullable required

When tracked links and open pixels started using the custom tracking host (tracking_subdomain). Non-null only while sends actually use it: the domain is verified (or degraded) and the host's last check proved it answers over HTTPS. Otherwise null, and links use the default tracking host. A host that stops answering, or a domain that's no longer verified, goes back to null.

verified_atstring nullable required
created_atstring required
updated_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.