Verify identity

Re-run DNS verification for a domain identity (after publishing records), or confirm an email-address identity (with the verification token).

POST /api/v1/partner/email/identities/:type/:value/verify

Domain verification

curl -X POST \
  https://apis.splashifypro.com/api/v1/partner/email/identities/DOMAIN/yourcompany.com/verify \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"

Response:

{
  "success": true,
  "status": "VERIFIED",
  "spf_ok": true,
  "dkim_ok": true,
  "dmarc_ok": true,
  "dns_records": { ... }
}

When all three records pass, status flips to VERIFIED. If any record fails, status stays PENDING (or flips to FAILED after multiple unsuccessful attempts) — the per-record pass flags tell you which records to fix.

Email-address verification

curl -X POST \
  https://apis.splashifypro.com/api/v1/partner/email/identities/EMAIL_ADDRESS/alerts@yourcompany.com/verify \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token": "abc123..."}'

The token is the verification_token returned from POST /identities.

Rate limiting

We rate-limit re-verify calls to once per 60 seconds per identity to prevent DNS-server hammering. Calls inside the window return 429 RATE_LIMITED.

Auto-recheck behaviour

We automatically re-check:

• Pending identities every 1 hour for 7 days
• Verified identities every 24 hours

If a verified domain’s records disappear, status flips back to PENDING and we email you. You can always trigger a manual re-check via this endpoint.