RRadar
Websites & security

DMARC SPF MX Lookup API

Check the email DNS setup of up to 50 domains per call: MX records (do the hosts resolve), SPF (parsed, DNS lookup count against the limit of 10 with includes resolved), DMARC (policy, pct, reports, alignment), DKIM for your selectors and common ones, MTA-STS, TLS-RPT and BIMI, with a score, a grade and a fix for every issue. Change monitor mode returns only domains whose records changed. A resolver outage is reported as unavailable, never as no record.

Example request

curl -X POST https://radarbg.com/v1/email-dns-dmarc-spf-check \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"domains": ["google.com", "github.com", "example.com"], "dkimSelectors": ["selector1"], "onlyNew": false, "monitorId": "default"}'

Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.

Inputs

FieldTypeDescription
domainsarrayDomains to check, up to 50 per call, bare names like example.com (no https://, no mailbox). The API answers 400 above 50 (the Actor checks the first 50). Each row shows your input and the checked (lowercased) domain; duplicates are checked
domainstringOptional: exactly one domain, e.g. example.com. It is never split: a value with spaces, commas, semicolons or new lines returns one invalid_format row. Use domains for a list.
dkimSelectorsarrayOptional. Your own DKIM selector names (the part before ._domainkey), up to 20 (the API answers 400 above 20 or for an invalid name), for example s1 or mimecast20240101. They are checked in addition to the common ones: google, selector1, se
onlyNewbooleanReturn only domains whose MX, SPF, DMARC, DKIM, MTA-STS, TLS-RPT or BIMI records changed since the last run with this Monitor ID (the first run returns all). Use it on a schedule to watch your domains or your customers' domains.
monitorIdstringName of the watch list for the changed-domains mode, e.g. my-domains. Each Monitor ID keeps its own memory.

Price

Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.

Related APIs

Domain Security ReportDomain WHOIS LookupLighthouse PageSpeed CheckerLink Preview APIPackage VulnerabilitiesSecurity Headers & SSL Certificate Checker APISecurity ScanTech Stack Lookup APIWeb FetchWeb Page Report