Get a sending domain
Returns a single sending domain, including its DNS records and verification details.
Returns a single sending domain, including its DNS records and verification details.
apiKeyx-api-key<token>id*string^dom_[0-9a-hjkmnp-tv-z]{16,24}$EmailDomainDetailed
application/json- response
unknownRecipientMailboxId*|The active mailbox on this domain that receives unknown addresses when catch-all has no webhook endpoint, or null to drop them without a bounce.
id*EmailDomainId^dom_[0-9a-hjkmnp-tv-z]{16,24}$domain*stringphase*string"dns-setup""provisioning""verifying""ready""degraded""failed"dkimSelector?string|nulldkimPublicKey?string|nulldnsRecords*array<>verifiedAt*string|nullnamespaceId*|The namespace the domain belongs to, or null at organization level. Only that namespace's keys and organization-wide callers reach it.
isDefault*booleandeliverability*Bounce and complaint rates over the last 24 hours, as fractions between 0 and 1, with windowSends, the deliveries they were divided by, plus sendingStatus, which says whether the organization can currently send. The window matches the one the sending-pause rule reads. Below 200 sends that rule ignores the window entirely, so a rate over a smaller windowSends is a quotient rather than a reading. These are not a lifetime record; an identity with no traffic in the window reports zeroes.
createdAt*stringupdatedAt*stringimport { createClient } from "samva";const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });const result = await samva.email.getDomainById({ "id": "example"});{ "unknownRecipientMailboxId": "string", "id": "string", "domain": "string", "phase": "dns-setup", "dkimSelector": "string", "dkimPublicKey": "string", "dnsRecords": [ { "type": "A", "name": "string", "value": "string", "ttl": "string", "description": "string", "priority": 0 } ], "verifiedAt": "string", "namespaceId": "string", "isDefault": true, "deliverability": { "bounceRate": 0, "complaintRate": 0, "windowSends": 0, "sendingStatus": "enabled" }, "createdAt": "string", "updatedAt": "string"}Related documentation
Check automatic Custom Tracking Domain setup eligibility
Reports whether the domain's DNS provider supports Domain Connect for its current Custom Tracking Domain.
Check one-click DNS eligibility
Reports whether the domain's DNS provider supports Domain Connect one-click setup for Samva, and the provider's name when it does.