/

API REFERENCE · Published 2026-10-06 · Updated 2026-10-06 · SecureSMTP

Get sending-domain status

GET /api/v1/mail/domain-status

GEThttps://securessmtp.com/api/v1/mail/domain-status

Returns the site’s sending domains and the sender mode that POST /mail/send will use. It only reads; to check DNS again, use the Verify button in the dashboard.

Headers

x-securessmtp-api-keystringrequired
The site’s API key (qcs_live_…). x-securesmtp-api-key and x-qcs-api-key are accepted too. See Sites and API keys.

Parameters

None.

Request

curl https://securessmtp.com/api/v1/mail/domain-status \
  -H "x-securessmtp-api-key: $SECURESSMTP_API_KEY"

Response

200
{
  "ok": true,
  "site": {
    "name": "Acme Store",
    "domain": "acme.example"
  },
  "has_verified_domain": true,
  "effective_mode": "domain",
  "verified": {
    "domain": "acme.example",
    "from_address": "[email protected]",
    "verified_at": "2026-10-01T09:12:44.000Z"
  },
  "domains": [
    {
      "domain": "acme.example",
      "status": "verified",
      "from_address": "[email protected]",
      "verified_at": "2026-10-01T09:12:44.000Z",
      "last_checked_at": "2026-10-01T09:12:44.000Z",
      "created_at": "2026-09-30T16:03:10.000Z"
    }
  ],
  "dashboard_url": "https://securessmtp.com/app/forms/email"
}
Response fields
okbooleanrequired
true.
siteobjectrequired
name and domain of the site the key belongs to.
has_verified_domainbooleanrequired
true when a domain has status verified and a From address.
effective_mode'domain' | 'relay'required
The mode auto and domain sends will use now. sender_mode: "relay" always uses relay.
verifiedobject | nullrequired
The usable domain: domain, from_address, verified_at (ISO 8601). null if none.
domainsobject[]required
Every sending domain of the site, newest first: domain, status (for example pending or verified), from_address, verified_at, last_checked_at (ISO 8601 or null) and created_at.
dashboard_urlstringrequired
Where to add and verify sending domains.

Errors

Errors have "ok": false and a reason.

HTTPValueMeaningWhat to do
401missing_api_keyNo key header was sent.Send the key in the x-securessmtp-api-key header.
401invalid_api_keyNo site has this key. Keys stop working as soon as they are rotated.Copy the current key from the dashboard, or rotate it to get a new one.
403site_disabledThe site is disabled.Check GET /blocks/status. See Blocks.

To add or verify a domain, see Domains and DNS.

Previous
Send an email
Next
Submit a form