Check a domain now
POST/v1/domains/{id}/verify
Re-reads public DNS and the sending provider’s verification immediately. We also re-check automatically; a domain that was verified and loses its records stops sending until it is fixed.
Required scope: domains:manage
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The domain id. |
Example
curl -X POST 'https://api.sendsend.email/v1/domains/ID/verify' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"id": "dom_DCdfxpkhLqMhmBdY",
"object": "domain",
"domain": "mail.acme.com",
"status": "pending",
"failure_reason": null,
"verified_at": null,
"last_checked_at": null,
"created_at": "2026-10-06T15:00:00.000Z",
"records": [
{
"purpose": "dkim",
"required": true,
"type": "CNAME",
"name": "abc123._domainkey.mail.acme.com",
"value": "abc123.dkim.amazonses.com",
"dns": "unchecked"
}
],
"dns_summary": {
"required_total": 3,
"required_found": 0,
"checked": false
}
}Errors
| Status | Code | When |
|---|---|---|
| 404 | not_found | No such resource in this project. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.