Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Email & Domain Live on Hub

Email Deliverability & DNS Auditor API — Check SPF, DMARC, MX, BIMI & MTA-STS

Audit MX, SPF 10-lookup limits, DMARC, DKIM, BIMI, and MTA-STS with a 0–100 score. Audit domain email deliverability via DNS-over-HTTPS: validate MX, SPF lookup limits (<10), DMARC policy, DKIM selectors, BIMI, and MTA-STS.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/email-dnsinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "domain": "cloudflare.com",
    "score": 95,
    "grade": "A",
    "checks": {
      "mx": {
        "status": "pass",
        "score": 20,
        "max_score": 20,
        "records": [
          "10 isaac.mx.cloudflare.net",
          "20 linda.mx.cloudflare.net"
        ],
        "issues": [],
        "fix": null
      },
      "spf": {
        "status": "pass",
        "score": 25,
        "max_score": 25,
        "records": [
          "v=spf1 ip4:199.15.212.0/22 include:_spf.google.com -all"
        ],
        "issues": [],
        "fix": null
      },
      "dmarc": {
        "status": "pass",
        "score": 25,
        "max_score": 25,
        "records": [
          "v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:dmarc@cloudflare.com"
        ],
        "issues": [],
        "fix": null
      },
      "dkim": {
        "status": "pass",
        "score": 20,
        "max_score": 20,
        "records": [
          "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A..."
        ],
        "issues": [],
        "fix": null,
        "found_selectors": [
          "cf2024-1"
        ],
        "checked_selectors": [
          "cf2024-1"
        ]
      },
      "mta_sts": {
        "status": "warn",
        "score": 5,
        "max_score": 10,
        "records": [
          "v=STSv1; id=20260101T000000Z"
        ],
        "issues": [],
        "fix": null
      }
    },
    "fixes": []
  },
  "meta": {
    "request_id": "req_edns_01",
    "ms": 42
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/email-dns" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"domain":"cloudflare.com","dkim_selectors":["cf2024-1"],"records":{"mx":["10 isaac.mx.cloudflare.net","20 linda.mx.cloudflare.net"],"txt":["v=spf1 ip4:199.15.212.0/22 include:_spf.google.com -all"],"dmarc":["v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:dmarc@cloudflare.com"],"dkim":{"cf2024-1":["v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A"]},"mta_sts":["v=STSv1; id=20260101T000000Z"]}}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/email-dns", {
  "domain": "cloudflare.com",
  "dkim_selectors": [
    "cf2024-1"
  ],
  "records": {
    "mx": [
      "10 isaac.mx.cloudflare.net",
      "20 linda.mx.cloudflare.net"
    ],
    "txt": [
      "v=spf1 ip4:199.15.212.0/22 include:_spf.google.com -all"
    ],
    "dmarc": [
      "v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:dmarc@cloudflare.com"
    ],
    "dkim": {
      "cf2024-1": [
        "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A"
      ]
    },
    "mta_sts": [
      "v=STSv1; id=20260101T000000Z"
    ]
  }
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/email-dns",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "domain": "cloudflare.com",
  "dkim_selectors": [
    "cf2024-1"
  ],
  "records": {
    "mx": [
      "10 isaac.mx.cloudflare.net",
      "20 linda.mx.cloudflare.net"
    ],
    "txt": [
      "v=spf1 ip4:199.15.212.0/22 include:_spf.google.com -all"
    ],
    "dmarc": [
      "v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:dmarc@cloudflare.com"
    ],
    "dkim": {
      "cf2024-1": [
        "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A"
      ]
    },
    "mta_sts": [
      "v=STSv1; id=20260101T000000Z"
    ]
  }
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/email-dns", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "domain": "cloudflare.com",
  "dkim_selectors": [
    "cf2024-1"
  ],
  "records": {
    "mx": [
      "10 isaac.mx.cloudflare.net",
      "20 linda.mx.cloudflare.net"
    ],
    "txt": [
      "v=spf1 ip4:199.15.212.0/22 include:_spf.google.com -all"
    ],
    "dmarc": [
      "v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:dmarc@cloudflare.com"
    ],
    "dkim": {
      "cf2024-1": [
        "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A"
      ]
    },
    "mta_sts": [
      "v=STSv1; id=20260101T000000Z"
    ]
  }
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_email_dns",
    "arguments": {
      "domain": "cloudflare.com",
      "dkim_selectors": [
        "cf2024-1"
      ],
      "records": {
        "mx": [
          "10 isaac.mx.cloudflare.net",
          "20 linda.mx.cloudflare.net"
        ],
        "txt": [
          "v=spf1 ip4:199.15.212.0/22 include:_spf.google.com -all"
        ],
        "dmarc": [
          "v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:dmarc@cloudflare.com"
        ],
        "dkim": {
          "cf2024-1": [
            "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A"
          ]
        },
        "mta_sts": [
          "v=STSv1; id=20260101T000000Z"
        ]
      }
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/email-dns)

ParameterType & ConstraintsDescription
domain required string
minLen: 3, maxLen: 253
Domain name or email address to audit (e.g. 'tinplate.dev' or 'hello@tinplate.dev').
dkim_selectors optional string[] Optional custom DKIM selectors to probe in addition to common defaults.
records optional object Optional pre-fetched DNS records for offline auditing without live DNS-over-HTTPS queries.

Response data Object Fields (200 OK)

FieldTypeDescription
domain string Field 'domain'
score integer Field 'score'
grade "A" | "B" | "C" | "D" | "F" Field 'grade'
checks object Field 'checks'
fixes object[] Field 'fixes'

What Email DNS Deliverability Auditor API Detects & Validates

  • SPF RFC 7208 validation: recursive DNS lookup counter (flags >10 permerror), multiple SPF records, and +all/?all risks
  • DMARC RFC 7489 validation: p=none/quarantine/reject policy, subdomain sp=, pct=, and rua/ruf reporting URIs
  • MX record priority inspection, null MX (RFC 7505) detection, and DKIM selector probing
  • BIMI (default._bimi) and MTA-STS (_mta-sts) presence and syntax checks
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • DKIM requires knowing the selector names to query (e.g. google, selector1, s1) since DNS does not allow wildcard enumeration of _domainkey.
  • Queries live Cloudflare DNS-over-HTTPS (1.1.1.1); latency is typically 30–120 ms depending on SPF include depth.

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Does it count nested SPF include: lookups against the RFC 7208 10-lookup limit?

Yes, it traverses include, a, mx, ptr, and exists mechanisms to report the exact DNS lookup count.

What if I want to generate fixed SPF, DKIM, and DMARC records?

Pair this auditor with POST /v1/email-dns-generator to generate ready-to-publish DNS TXT records.

Why does Gmail/Yahoo bulk sender compliance require this?

Since 2024, Google and Yahoo require valid SPF, DKIM, and a DMARC record for all bulk senders.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Performs public DNS-over-HTTPS lookups only; no private data is stored.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/email-dns-generator Email & Domain

SPF, DKIM & DMARC Record Linter & Generator API

Lint existing SPF/DMARC strings and generate clean, RFC-compliant DNS TXT records.

POST /v1/signup-fraud Compliance & Business

Signup Fraud & Disposable Email Scorer API

Block disposable emails, alias abuse, and bot signups with a 0–100 fraud risk score.

POST /v1/security-headers Security & Secrets

HTTP Security Header Scanner API

Audit CSP, HSTS, and browser security headers with an A+ to F grade and fix snippets.