Skip to main content
GET
/
domain
/
{identifier}
Get domain by ID
curl --request GET \
  --url https://api.sendx.io/api/v1/rest/domain/{identifier} \
  --header 'X-Team-ApiKey: <api-key>'
{
  "id": "domain_504",
  "name": "sx13.email",
  "verified": false,
  "returnPathVerified": false,
  "dkimVerified": false,
  "trackVerified": false,
  "dmarcVerified": false,
  "gptVerified": false,
  "dkim": {
    "host": "sp-dkim._domainkey.sx13.email",
    "type": "TXT",
    "textValue": "v=DKIM1;k=rsa;s=email;h=sha256;p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1UYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB"
  },
  "returnPath": {
    "host": "sp-bounce.sx13.email",
    "type": "CNAME",
    "textValue": "sp.sendpost.info"
  },
  "track": {
    "host": "sp-track.sx13.email",
    "type": "CNAME",
    "textValue": "track.sptrackh.com"
  },
  "dmarc": {
    "host": "_dmarc.sx13.email",
    "type": "TXT",
    "textValue": "v=DMARC1; p=none;"
  },
  "gpt": {
    "host": "sx13.email",
    "type": "TXT",
    "textValue": ""
  },
  "dkimConfig": "{\"Domain\":\"sx13.email\",\"PubKey\":\"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1UYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\",\"PrivKey\":\"-----BEGIN RSA PRIVATE KEY-----\\nMIICXAIBAAKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu\\n3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1U\\nYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\\nAoGAH2MFvtZaO6xKFUCSsi8ETU0wALkyVOi5FmRFJJaA+q8dgYgAbXrphvdLzrey\\nUvYbUf1tKfo6l+gt6lLIjCySlJFUkFbHeQlch+ZfhvyCP+2zo6JrFSRosZGYsZhb\\ncBnnfzi+r6FDCiobLn8Y78eEli0RX7lvUC4VSJ6J2vTiybUCQQDJQqWqvPe8vdr+\\neHioA7YeWiCInhHD6ylKMqCwFTkdjbhUoK5rZmnQJ2xmAljEz7pdpgxeg8oNFLfO\\namXLKGSfAkEA8YcOmAC3sdTXYMptwnQ4Y4IOOaY/0HXM6YEnmRbN526CBRciUdj/\\ndoc24g+Ibx5IVPRkQBWuWiB6OIP5wY6BJwJAA93G5vfIXpTbHyZbUwb3ObALjfRT\\nbQsYePduBNPzi/DMCLwpfaCzCa+oMnF7GRTQhLoK5MntWMD8IvgCSpvVCwJAHhZY\\n9w5/06NUATa2XZbkv2CgLQZMxMcn856nNCbnF4FoqQGswM1rZXSKnbaZpF39XLfl\\nFSaeRZPuJcQrBLWf2QJBAKAakfXcnF3N5v37r3TMl31vrMyBBSihKTxs3y5b+JqQ\\nINkXkhATSdxwZzwLHbkGmzNVgrCTX5+ZrpxS9jTAUBE=\\n-----END RSA PRIVATE KEY-----\\n\",\"Selector\":\"sp-dkim\",\"Headers\":\"\"}",
  "dmarcFailureReason": "",
  "created": 1764924919882212400,
  "updated": 0
}
🎯 Purpose: Retrieve detailed information about a specific domain including all verification statuses and DNS record configurations. 💡 Use Cases:
  • Check specific domain verification status
  • Review DNS record details for troubleshooting
  • Verify domain configuration before sending
  • Audit domain setup for compliance
📊 Response Information: The response includes complete domain details:
  • All verification flags (verified, dkimVerified, dmarcVerified, trackVerified, etc.)
  • Complete DNS record objects (host, type, textValue) for:
    • DKIM configuration
    • Return Path (bounce handling)
    • Tracking domain
    • DMARC policy
    • GPT (Google Postmaster Tools)
  • DKIM configuration in JSON format
  • Domain creation and update timestamps
  • DMARC failure reasons (if any)
🔧 DNS Record Details: Each DNS record object contains:
  • host - The DNS hostname to configure
  • type - DNS record type (TXT, CNAME, etc.)
  • textValue - The value to set in the DNS record
⚡ Troubleshooting:
  • Check verification flags to identify which records need attention
  • Use DNS record details to configure your DNS provider
  • Review dmarcFailureReason if DMARC verification fails
  • Verify all DNS records are properly propagated

Authorizations

​
X-Team-ApiKey
string
header
required

Team API key for authentication. Find your API key in SendX Settings → Team API Key.

Example:

X-Team-ApiKey: your_team_api_key_here

Path Parameters

​
identifier
string
required

Domain identifier to retrieve

Pattern: ^(domain_)?[a-zA-Z0-9]{22}$

Response

✅ Domain retrieved successfully

​
id
string

Unique domain identifier with domain_ prefix

Pattern: ^domain_[a-zA-Z0-9]{22}$
Example:

"domain_504"

​
name
string

Domain name

Example:

"sx13.email"

​
verified
boolean

Overall domain verification status

Example:

false

​
returnPathVerified
boolean

Return path (bounce) verification status

Example:

false

​
dkimVerified
boolean

DKIM verification status

Example:

false

​
trackVerified
boolean

Tracking domain verification status

Example:

false

​
dmarcVerified
boolean

DMARC verification status

Example:

false

​
gptVerified
boolean

GPT (Google Postmaster Tools) verification status

Example:

false

​
dkim
object

DKIM DNS record configuration

​
returnPath
object

Return path (bounce) DNS record configuration

​
track
object

Tracking domain DNS record configuration

​
dmarc
object

DMARC DNS record configuration

​
gpt
object

GPT (Google Postmaster Tools) DNS record configuration

​
dkimConfig
string

DKIM configuration in JSON format

Example:

"{\"Domain\":\"sx13.email\",\"PubKey\":\"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1UYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\",\"PrivKey\":\"-----BEGIN RSA PRIVATE KEY-----\\nMIICXAIBAAKBgQC94euUPiD9e9jO4rgnjWYSa6YOcYz24SkrNPJ6u9AaeDG8Zvwu\\n3om4sxkGrQ3vO1hoX9RQnccBCM9y+9Z6fCFmwI6eGjtskxLPLThMSsjDACL3iI1U\\nYTZyuSHEk67QoLsgSmcTTtVjBGdtPi2w6SsXOauXav07wB7VPuDL/Q1zOQIDAQAB\\nAoGAH2MFvtZaO6xKFUCSsi8ETU0wALkyVOi5FmRFJJaA+q8dgYgAbXrphvdLzrey\\nUvYbUf1tKfo6l+gt6lLIjCySlJFUkFbHeQlch+ZfhvyCP+2zo6JrFSRosZGYsZhb\\ncBnnfzi+r6FDCiobLn8Y78eEli0RX7lvUC4VSJ6J2vTiybUCQQDJQqWqvPe8vdr+\\neHioA7YeWiCInhHD6ylKMqCwFTkdjbhUoK5rZmnQJ2xmAljEz7pdpgxeg8oNFLfO\\namXLKGSfAkEA8YcOmAC3sdTXYMptwnQ4Y4IOOaY/0HXM6YEnmRbN526CBRciUdj/\\ndoc24g+Ibx5IVPRkQBWuWiB6OIP5wY6BJwJAA93G5vfIXpTbHyZbUwb3ObALjfRT\\nbQsYePduBNPzi/DMCLwpfaCzCa+oMnF7GRTQhLoK5MntWMD8IvgCSpvVCwJAHhZY\\n9w5/06NUATa2XZbkv2CgLQZMxMcn856nNCbnF4FoqQGswM1rZXSKnbaZpF39XLfl\\nFSaeRZPuJcQrBLWf2QJBAKAakfXcnF3N5v37r3TMl31vrMyBBSihKTxs3y5b+JqQ\\nINkXkhATSdxwZzwLHbkGmzNVgrCTX5+ZrpxS9jTAUBE=\\n-----END RSA PRIVATE KEY-----\\n\",\"Selector\":\"sp-dkim\",\"Headers\":\"\"}"

​
dmarcFailureReason
string

Reason for DMARC verification failure (if any)

Example:

""

​
created
integer<int64>

Domain creation timestamp (nanoseconds since epoch)

Example:

1764924919882212400

​
updated
integer<int64>

Domain last update timestamp (nanoseconds since epoch)

Example:

0