{"uid":"cap_TI40EhDjgCkLBjN3J6AMa","slug":"mailcheck-api-email-and-domain-checks-de0fb604","name":"MailCheck API: Email and Domain Checks","description":"Email address and domain checks for AI agents: syntax, MX, disposable/role/free flags, typo suggestions, SPF/DMARC/DKIM, RDAP and a deliverability grade. Pay per item with x402 (USDC on Base) or Lightning sats. No signup.","url":"https://mailcheck.toolschemaforge.workers.dev/v1/email-check?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"email":{"type":"string"},"emails":{"type":"string","description":"Comma-separated addresses"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","required":["input","syntax_valid","flags","verdict","score","reasons"],"properties":{"mx":{"type":["object","null"],"properties":{"source":{"enum":["dns","known_provider"],"type":"string"},"status":{"enum":["ok","a_fallback","null_mx","none","nxdomain","error","skipped"],"type":"string"},"records":{"type":"array","items":{"type":"object","properties":{"exchange":{"type":"string"},"priority":{"type":"integer"}}}},"a_records":{"type":"array","items":{"type":"string"}}}},"email":{"type":["string","null"],"description":"Normalized address (lowercased, IDN domain in punycode)"},"flags":{"type":"object","properties":{"plus_tag":{"type":"boolean"},"disposable":{"type":"boolean"},"role_account":{"type":"boolean"},"free_provider":{"type":"boolean"}}},"input":{"type":"string"},"local":{"type":["string","null"]},"score":{"type":"integer","maximum":100,"minimum":0},"domain":{"type":["string","null"]},"reason":{"type":"string","description":"Syntax failure code when syntax_valid is false"},"reasons":{"type":"array","items":{"type":"string"}},"verdict":{"enum":["valid","risky","invalid","disposable","unknown"],"type":"string"},"canonical":{"type":["string","null"],"description":"Provider-aware canonical form (+tags removed, Gmail dots removed)"},"suggestion":{"type":["string","null"],"description":"Likely intended domain for a typo, e.g. gmail.com for gmial.com"},"syntax_valid":{"type":"boolean"}}}},"summary":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"results":[{"mx":{"source":"dns","status":"ok","records":[{"exchange":"mx.example-parking.net","priority":10}]},"email":"jane.doe@gmial.com","flags":{"plus_tag":false,"disposable":false,"role_account":false,"free_provider":false},"input":"jane.doe@gmial.com","local":"jane.doe","score":60,"domain":"gmial.com","reasons":["possible typo: did you mean gmail.com?"],"verdict":"risky","canonical":"jane.doe@gmial.com","suggestion":"gmail.com","syntax_valid":true}],"summary":{"risky":1,"valid":0,"invalid":0,"unknown":0,"disposable":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_crAsy5OJT71uw2LkjEqKN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates email addresses by checking syntax, MX records, disposable/role/free flags, typo suggestions, and SPF/DMARC/DKIM authentication, returning a deliverability grade and verdict.","exampleAgentPrompt":"Can you check whether jane.doe@gmial.com is a valid, deliverable email address — flag if it looks like a typo, a disposable address, or a role account, and give me a deliverability score?","exampleUseCases":[{"title":"Block fake signups at registration","prompt":"Before we create an account for the email address 'user@mailinator.com', can you check if it's a disposable or role-based address, validate the syntax, and tell me the deliverability verdict so we can decide whether to block it?"},{"title":"Fix typo in lead capture form","prompt":"A lead submitted 'sarah.jones@gmai.com' on our contact form — can you check if that looks like a typo and suggest the correct email address, along with whether it has working MX records?"},{"title":"Audit a batch of subscriber emails","prompt":"I have a list of email addresses — 'alice@example.com, bob@trashmail.com, carol@company.org' — can you validate each one, flag any disposable or risky ones, and give me a score and verdict for each?"}],"resultDescription":"Returns a JSON object with a results array; each item includes the normalized email, local and domain parts, syntax validity, MX record details (status, records, source), flags (disposable, role account, free provider, plus tag), a 0–100 deliverability score, a verdict (valid/risky/invalid/disposable/unknown), a list of reasons, a canonical form, and a typo suggestion if applicable. Also includes a summary count by verdict category.","failureModes":["Missing email or emails query parameter returns an error","Invalid or malformed email input may return syntax_valid: false with a reason code","DNS lookup failures for MX records result in mx.status: error or skipped","Payment not included or insufficient results in HTTP 402 payment required","Rate limiting or quota exceeded may return HTTP 429","Non-existent domain returns mx.status: nxdomain"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, per-item email validation that goes beyond simple regex — including MX/DNS checks, disposable address detection, typo correction, deliverability scoring, and SPF/DMARC/DKIM checks — with no API key or signup required and pay-per-call pricing via USDC or Lightning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:35.974Z","isFirstParty":false,"canonicalSlug":"mailcheck-api-email-and-domain-checks-de0fb604"}