Skip to main content
GET
AhaSend Go SDK
The AhaSend API returns a specific domain by name.

Authorizations

Authorization
string
header
required

API key for authentication. Non-empty Security Requirement values are AhaSend API-key roles. Roles listed within one requirement object are jointly required; separate requirement objects are alternatives.

Path Parameters

account_id
string<uuid>
required

Account ID

domain
string<hostname>
required

Domain name

Response

Domain details

object
enum<string>
required

Object type identifier

Available options:
domain
id
string<uuid>
required

Unique identifier for the domain

created_at
string<date-time>
required

When the domain was created

updated_at
string<date-time>
required

When the domain was last updated

domain
string
required

The domain name

account_id
string<uuid>
required

Account ID this domain belongs to

dns_records
object[]
required

DNS records required for domain verification

last_dns_check_at
string<date-time> | null
required

When DNS records were last checked

dns_valid
boolean
required

Whether all required DNS records are properly configured

tracking_subdomain
string | null
required

Custom tracking subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.

return_path_subdomain
string | null
required

Custom return-path subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.

subscription_subdomain
string | null
required

Custom subscription management subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.

media_subdomain
string | null
required

Custom media subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.

dkim_rotation_interval_days
integer | null
required

Custom DKIM rotation interval in days. Null means the account default is used. Only supported for managed DNS domains.

dkim_selector
string | null
required

Per-domain DKIM selector override. Null means no per-domain override is set.

This reports the configured per-domain override only, not the effective selector used for DKIM signing. The effective selector is resolved separately and can differ — for example, a selector locked after DNS verification takes precedence over this override.

rotation_ready
boolean
required

Whether the standby DKIM slot is ready for rotation.

dsn_recipient
string | null
required

Optional recipient address for delivery status notifications.

sending_type
enum<string>
required

The type of email that you send from the domain. The sending type affects your deliverability. Marketing email from a transactional domain can get your account paused.

Available options:
transactional,
marketing
paused
boolean
required

Whether sending from the domain is paused. While the domain is paused, new email from it is refused, and you cannot delete or rename it. Your other domains continue to send.

paused_at
string<date-time> | null
required

When sending from the domain was paused. Null when the domain is not paused.

pause_reason
string | null
required

The reason of the pause. Null when the domain is not paused.

  • bounce_rate: too many recent emails from the domain bounced.