Domains

Verify domain

Run the DNS checks now and return the updated domain. status becomes verified when SPF, DKIM and DMARC all pass, otherwise it stays pending; each check is verified or failed.

POSThttps://api.sndr.sh/api/cranl/v1/domains/{id}/verify
Verify domain
curl -X POST 'https://api.sndr.sh/api/cranl/v1/domains/dom_a7c2e910-4b1/verify' \
  -H 'Authorization: Bearer sndr_your_access_token'
200OK
{
  "id":              "dom_a7c2e910-4b1",
  "organization_id": "org_8d41c7a2-3f6",
  "name":            "mail.acme.com",
  "status":          "pending",
  "region":          "us-east-1",
  "spf_status":      "verified",
  "dkim_status":     "verified",
  "dmarc_status":    "failed",
  "mx_status":       "verified",
  "tls_rpt_status":  "failed",
  "mta_sts_status":  "failed",
  "bimi_status":     "failed",
  "records": [
    {
      "type":     "TXT",
      "name":     "_dmarc.mail.acme.com",
      "value":    "v=DMARC1; p=quarantine; rua=mailto:dmarc@mail.acme.com; ruf=mailto:dmarc@mail.acme.com; pct=100; adkim=r; aspf=r",
      "status":   "failed",
      "hint":     "Policy that ties SPF + DKIM together. Tells receivers what to do with messages that fail.",
      "required": true,
      "label":    "DMARC"
    }
  ],
  "created_at": "2026-06-01T12:00:00Z"
}

Authorization

Authorizationstringheaderrequired

Bearer followed by an access token. Needs the send scope.

Path parameters

idstringrequired

Domain ID (dom_...).

Errors

401unauthenticatedMissing or invalid Bearer token.
401token_expiredAccess token expired — exchange the refresh token for a new pair.
401token_revokedToken was explicitly revoked.
403insufficient_scopeToken is missing the send scope.
404not_foundResource does not exist or belongs to a different account.