Domains
More ways to use this page
List the sending domains
GET/v1/
TypeScript account
Python account
Key ak_… an account key
Responses
200Every sending domain of the account.
domainsarray of objectrequireddomainIdstring (uuid)requireddomainstringrequiredverifiedbooleanrequiredTrue while both records count as found; only then may mail go out. A lookup that fails at the resolver never changes it, and a record found missing on a verified domain starts a 24-hour warning (failingSince) through which the domain stays verified.
createdAtstring (date-time)requiredlastCheckedAtstring (date-time) or nullrequiredWhen the records were last looked up.
failingSincestring (date-time) or nullrequiredWhen a check first found a record of this verified domain missing or wrong. Mail keeps going out, the records are looked up hourly, and the first check 24 hours after this that still misses one ends the verification. Null unless the domain is verified and in that warning; verified and each record tell the rest.
returnPathobjectrequiredThe return-path record, which also satisfies SPF.
type"CNAME"requiredhoststringrequiredThe name to create the record under.
valuestringrequiredThe value the record must hold.
verifiedbooleanrequiredverifiedAtstring (date-time) or nullrequired
dkimobjectrequiredThe DKIM public key record.
type"TXT"requiredhoststringrequiredThe name to create the record under.
valuestringrequiredThe value the record must hold.
verifiedbooleanrequiredverifiedAtstring (date-time) or nullrequired
Example (26 lines)
{
"domains": [
{
"domainId": "0d7f6a1e-4c0b-4b7e-9d3c-2a1f5e8b9c01",
"domain": "example.se",
"verified": false,
"createdAt": "2026-09-15T12:00:00.000Z",
"lastCheckedAt": null,
"failingSince": null,
"returnPath": {
"type": "CNAME",
"host": "sendora-bounces.example.se",
"value": "bounces.sendora.se",
"verified": false,
"verifiedAt": null
},
"dkim": {
"type": "TXT",
"host": "s1._domainkey.example.se",
"value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...",
"verified": false,
"verifiedAt": null
}
}
]
}Errors
Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.
| Code | Status | Meaning |
|---|---|---|
unauthorized | 401 | The key is missing, malformed or revoked. |
wrong_ | 403 | The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes. |