API reference

Domain health

Check that a sending domain has the SPF, DKIM and DMARC records Gmail, Yahoo and Outlook expect, and isn't on a blocklist.

POST/v1/domains/check

Checks a domain once. Doesn't count towards your quota.

bash

curl https://api.bouncerly.com/v1/domains/check \
  -H "Authorization: Bearer $BOUNCERLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourcompany.com", "dkim_selector": "s1", "ip": "203.0.113.7"}'

dkim_selector and ip are optional. Without a selector we look for DKIM keys at the selectors common providers use; with ip we also check your sending IP against the major blocklists.

200 OK

{
  "domain": "yourcompany.com",
  "status": "warn",
  "checks": [
    { "name": "mx", "status": "pass", "summary": "Receives email", "record": "aspmx.l.google.com" },
    { "name": "spf", "status": "pass", "summary": "SPF is set up", "record": "v=spf1 include:_spf.google.com ~all" },
    { "name": "dkim", "status": "pass", "summary": "DKIM is set up", "record": "Selectors: google" },
    { "name": "dmarc", "status": "warn", "summary": "DMARC is only monitoring (p=none)", "detail": "…" },
    { "name": "blocklist_domain", "status": "pass", "summary": "Domain isn't on Spamhaus DBL or SURBL" }
  ],
  "checked_at": "2026-10-28T21:30:00Z"
}

Status	Meaning
`pass`	Set up correctly.
`warn`	Works, but could be better, or we couldn't check it.
`fail`	Likely to send your mail to spam or get it rejected.

Daily monitoring

POST/v1/domains

Takes the same body, saves the domain and checks it now. Saved domains are re-checked every day, and your workspace's owners and admins get an email when one starts failing and when it's fixed. Up to 20 per workspace.

GET/v1/domains

Lists saved domains with their latest report.

DELETE/v1/domains/{domain}

Stops monitoring a domain.