Email DNS Deliverability Auditor API
Audit MX, SPF 10-lookup limits, DMARC, DKIM, BIMI, and MTA-STS with a 0–100 score.
Lint existing SPF/DMARC strings and generate clean, RFC-compliant DNS TXT records. Generate and lint RFC-compliant SPF, DMARC, MTA-STS, TLS-RPT, and BIMI DNS TXT records from structured sender configuration.
{
"ok": true,
"data": {
"domain": "example.com",
"records": {
"spf": {
"type": "TXT",
"host": "example.com",
"value": "v=spf1 ip4:203.0.113.10/32 include:_spf.google.com include:sendgrid.net -all"
},
"dmarc": {
"type": "TXT",
"host": "_dmarc.example.com",
"value": "v=DMARC1; p=quarantine; sp=quarantine; adkim=s; aspf=s; pct=100; rua=mailto:dmarc-reports@example.com;"
},
"tls_rpt": {
"type": "TXT",
"host": "_smtp._tls.example.com",
"value": "v=TLSRPTv1; rua=mailto:dmarc-reports@example.com"
},
"mta_sts_txt": {
"type": "TXT",
"host": "_mta-sts.example.com",
"value": "v=STSv1; id=2026111401"
}
},
"spf_estimated_dns_lookups": 5,
"spf_within_10_lookup_limit": true,
"lint_issues": []
},
"meta": {
"request_id": "req_edg_01",
"ms": 1
}
}
curl -X POST "https://api.tinplate.dev/v1/email-dns-generator" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TINPLATE_KEY" \
-d '{"domain":"example.com","providers":["google_workspace","sendgrid"],"ip4":["203.0.113.10/32"],"spf_policy":"hardfail","dmarc_policy":"quarantine","rua_emails":["dmarc@example.com"]}'import { TinplateClient } from "@tinplate/sdk";
const tinplate = new TinplateClient({
apiKey: process.env.TINPLATE_API_KEY!,
});
const { data, meta } = await tinplate.call("/v1/email-dns-generator", {
"domain": "example.com",
"providers": [
"google_workspace",
"sendgrid"
],
"ip4": [
"203.0.113.10/32"
],
"spf_policy": "hardfail",
"dmarc_policy": "quarantine",
"rua_emails": [
"dmarc@example.com"
]
});
console.log(`[${meta.ms} ms]`, data);import requests
response = requests.post(
"https://api.tinplate.dev/v1/email-dns-generator",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
json={
"domain": "example.com",
"providers": [
"google_workspace",
"sendgrid"
],
"ip4": [
"203.0.113.10/32"
],
"spf_policy": "hardfail",
"dmarc_policy": "quarantine",
"rua_emails": [
"dmarc@example.com"
]
}
)
print(response.json())const response = await fetch("https://api.tinplate.dev/v1/email-dns-generator", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
body: JSON.stringify({
"domain": "example.com",
"providers": [
"google_workspace",
"sendgrid"
],
"ip4": [
"203.0.113.10/32"
],
"spf_policy": "hardfail",
"dmarc_policy": "quarantine",
"rua_emails": [
"dmarc@example.com"
]
}),
});
const result = await response.json();
console.log(result);{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tinplate_email_dns_generator",
"arguments": {
"domain": "example.com",
"providers": [
"google_workspace",
"sendgrid"
],
"ip4": [
"203.0.113.10/32"
],
"spf_policy": "hardfail",
"dmarc_policy": "quarantine",
"rua_emails": [
"dmarc@example.com"
]
}
}
}POST /v1/email-dns-generator)| Parameter | Type & Constraints | Description |
|---|---|---|
domain required |
stringminLen: 3, maxLen: 253 |
Target email domain. |
providers optional |
string[]default: [] |
Known ESPs whose official SPF includes should be added. |
custom_includes optional |
string[]default: [] |
Field 'custom_includes' |
ip4 optional |
string[]default: [] |
Field 'ip4' |
ip6 optional |
string[]default: [] |
Field 'ip6' |
allow_mx optional |
booleandefault: false |
Field 'allow_mx' |
allow_a optional |
booleandefault: false |
Field 'allow_a' |
spf_policy optional |
"hardfail" | "softfail" | "neutral"default: "hardfail" |
Field 'spf_policy' |
dmarc_policy optional |
"none" | "quarantine" | "reject"default: "reject" |
Field 'dmarc_policy' |
dmarc_subdomain_policy optional |
"none" | "quarantine" | "reject" |
Field 'dmarc_subdomain_policy' |
dmarc_pct optional |
integermin: 1, max: 100, default: 100 |
Field 'dmarc_pct' |
rua_emails optional |
string[]default: [] |
Field 'rua_emails' |
ruf_emails optional |
string[]default: [] |
Field 'ruf_emails' |
adkim optional |
"r" | "s"default: "s" |
Field 'adkim' |
aspf optional |
"r" | "s"default: "s" |
Field 'aspf' |
existing_spf optional |
stringmaxLen: 1024 |
Optional existing SPF TXT record to lint for RFC 7208 errors. |
existing_dmarc optional |
stringmaxLen: 1024 |
Optional existing DMARC TXT record to lint for RFC 7489 errors. |
data Object Fields (200 OK)| Field | Type | Description |
|---|---|---|
domain |
string |
Field 'domain' |
records |
object |
Field 'records' |
spf_estimated_dns_lookups |
integer |
Field 'spf_estimated_dns_lookups' |
spf_within_10_lookup_limit |
boolean |
Field 'spf_within_10_lookup_limit' |
lint_issues |
object[] |
Field 'lint_issues' |
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 →
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).
| Plan | Monthly Price | Included Requests | Rate Limit | Max Payload | Best For |
|---|---|---|---|---|---|
| BASIC | $0.00 / mo | 500 / month | 10 req / min | 64 KB | Evaluation & CI smoke tests |
| PRO | $9.99 / mo | 15,000 / month | 60 req / min | 128 KB | Solo devs & production apps |
| ULTRA | $29.99 / mo | 100,000 / month | 300 req / min | 256 KB | Growing SaaS & multi-agent pipelines |
| MEGA | $79.99 / mo | 500,000 / month | 1,000 req / min | 256 KB | High-volume enterprise workloads |
Email DNS Auditor (/v1/email-dns) inspects live domain DNS records, while Email DNS Generator (/v1/email-dns-generator) builds and repairs the exact TXT records your users need to paste into their DNS provider.
Yes, it flags records exceeding 255 characters and provides properly quoted multi-string splits.
Google Workspace, Microsoft 365, SendGrid, Amazon SES, Mailgun, Postmark, Mailchimp, Resend, and HubSpot.
100% deterministic in-memory execution; zero network calls or logging.
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.
Audit MX, SPF 10-lookup limits, DMARC, DKIM, BIMI, and MTA-STS with a 0–100 score.
Block disposable emails, alias abuse, and bot signups with a 0–100 fraud risk score.
Audit CSP, HSTS, and browser security headers with an A+ to F grade and fix snippets.