Skip to content

Verify a domain

POST /v1/domains/{id}/verify

Queries live DNS for each record and reports per-record results. When all required records pass, the domain becomes verified and live sending from it works immediately.

Response 200

{
"id": "0d1f...",
"domain": "paylink.ng",
"status": "verified",
"checks": [
{ "purpose": "spf", "host": "paylink.ng", "required": true, "pass": true },
{ "purpose": "dkim", "host": "sb._domainkey.paylink.ng", "required": true, "pass": true },
{ "purpose": "dmarc", "host": "_dmarc.paylink.ng", "required": false, "pass": false }
]
}

DMARC is recommended but not required for verification. Records that have not propagated yet simply show "pass": false; call again after propagation.