Documentation

Deliverability tooling

Auth audits, BIMI assets, DMARC reports, DNSBL and DNS snapshots.

GET /v1/domains/{id}/audit runs live checks for one sending domain. The platform-wide audit at GET /v1/deliverability/audit adds every sending IP and its cached DNSBL state. Checks return pass, warn, fail or info with the observed record and the exact fix.

  • • SPF include coverage against every platform sending IP.
  • • Exact DKIM selector and public-key match.
  • • DMARC policy, reporting address and enforcement.
  • • MX, MTA-STS and TLS-RPT publication.
  • • PTR/forward DNS and platform SPF for each sending IP, plus DNSBL/RBL state.

BIMI assets. When a default._bimi record exists, the audit fetches the logo over HTTPS without redirects and validates that it is a square SVG with no scripts, event handlers, external references, embedded images, animation or filters. It fetches the authority evidence, parses the certificate and reports its validity window. BIMI also requires DMARC p=quarantine or p=reject with pct=100. Certificate chain, logo binding and mailbox display are not claimed.

DMARC aggregate reports sent to [email protected] are parsed from XML, gzip and zip attachments. The domain page and GET /v1/domains/{id}/dmarc show 30-day volume, source IPs, DKIM/SPF auth domains, header and envelope From, dispositions, counts and first/last seen windows.

Listings can be turned into removal cases with an evidence snapshot, zone playbook and manual submitted/removed tracking; submissions are never automatic. A six-hour loop snapshots SPF, DKIM, DMARC, MX, MTA-STS, TLS-RPT, BIMI records and BIMI assets. Admins are alerted on changes and domain.degraded is emitted when an authentication record regresses to fail.

audit and reports
GET  /v1/domains/dom_…/audit   # live auth, BIMI and IP checks
GET  /v1/domains/dom_…/dmarc   # aggregate reports and trends
POST /v1/deliverability/blocklists/refresh   # platform admin

Need the full API surface? OpenAPI 3.1.