{"uid":"cap_BLXg6-XMy9NySAJZYc8WD","slug":"email-check-be6f32cf","name":"Email Check","description":"Use when an agent is about to email or sign up a contact. Input: email. Output: JSON verdict (deliverable, risky, undeliverable) with reasons, MX hosts, null MX, SPF and DMARC policy, disposable domain, role account, free provider. No SMTP probe, so the mailbox itself is not verified. Malformed address refused before payment. Example: ?email=info@example.com","url":"https://1gateway.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","required":["email"],"properties":{"email":{"type":"string","maxLength":254,"description":"Email address to check"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["email","domain","verdict","reasons","syntax","dns","disposable","roleAccount","freeProvider","mailboxVerified"],"properties":{"dns":{"type":"object","properties":{"mx":{"type":"array","items":{"type":"object","additionalProperties":true}},"spf":{"type":"object","properties":{"all":{"type":["string","null"]},"record":{"type":["string","null"]},"present":{"type":"boolean"}},"additionalProperties":true},"dmarc":{"type":"object","properties":{"policy":{"type":["string","null"]},"record":{"type":["string","null"]},"present":{"type":"boolean"}},"additionalProperties":true},"exists":{"type":"boolean"},"nullMx":{"type":"boolean"},"implicitMx":{"type":"boolean"}},"additionalProperties":true},"email":{"type":"string"},"domain":{"type":"string"},"syntax":{"type":"object","properties":{"valid":{"type":"boolean"}},"additionalProperties":true},"reasons":{"type":"array","items":{"type":"string"}},"verdict":{"type":"string"},"disposable":{"type":"boolean"},"roleAccount":{"type":"boolean"},"freeProvider":{"type":"boolean"},"mailboxVerified":{"type":"boolean"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"dns":{"mx":[{"host":"gmail-smtp-in.l.google.com","priority":5}],"spf":{"all":null,"record":"v=spf1 redirect=_spf.google.com","present":true},"dmarc":{"policy":"none","record":"v=DMARC1; p=none; sp=quarantine; rua=mailto:mailauth-reports@google.com","present":true},"exists":true,"nullMx":false,"implicitMx":false},"email":"support@gmail.com","notes":["No SMTP probe is made, so whether the mailbox itself exists is not checked; 'deliverable' means the domain accepts mail."],"cached":false,"domain":"gmail.com","syntax":{"valid":true},"reasons":["role_account"],"verdict":"risky","checkedAt":"2026-10-27T00:00:00.000Z","disposable":false,"attribution":"DNS via Cloudflare DNS-over-HTTPS; disposable domains from github.com/disposable-email-domains (CC0)","roleAccount":true,"freeProvider":true,"mailboxVerified":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MAu5vPOoutRjzpZr2PBQq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an email address for syntax, DNS/MX records, disposability, role-account status, free-provider detection, and deliverability verdict","exampleAgentPrompt":"Can you check whether support@gmail.com is a valid, deliverable email — specifically tell me if it's a role account, disposable address, or free provider, and whether the domain has MX and SPF records set up?","exampleUseCases":[{"title":"Filter risky signups before onboarding","prompt":"Before we send onboarding emails to these new signups, can you check whether info@tempmail.net is a disposable or role-based address so we can flag it as risky?"},{"title":"Verify lead email before CRM entry","prompt":"I'm about to add contact@acme.com to our CRM — can you validate that email, check if the domain has proper MX records, and tell me if it looks deliverable?"},{"title":"Detect throwaway email at registration","prompt":"A user just signed up with guerrillamail.org — can you check if that's a disposable email domain and give me a verdict on whether we should allow the account?"}],"resultDescription":"A JSON object with: overall verdict (e.g. 'deliverable', 'risky', 'undeliverable'), syntax validity, DNS existence and null-MX status, MX host list with priorities, SPF and DMARC records, disposable flag, role-account flag (e.g. info@, support@), free-provider flag (e.g. Gmail), mailbox verified flag, array of reasons driving the verdict, notes about methodology limitations, whether the result was cached, timestamp, and data attribution.","failureModes":["Missing or malformed email query parameter — returns error without charge","Email exceeds 254-character maximum length — validation error","Domain has no DNS records — DNS lookup failure reflected in response","SMTP mailbox existence is not probed — mailbox verified may be false even for real addresses","Network timeout reaching Cloudflare DNS-over-HTTPS — transient error, retry recommended"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-signup, pay-per-call email validation with DNS-level detail (MX, SPF, DMARC) plus disposable/role-account/free-provider classification. It is ideal for AI agents that need to triage email quality before sending messages, onboarding users, or storing leads. Prefer it over full SMTP verification services when you do not need actual mailbox probing (which this endpoint explicitly skips) and want transparent source attribution and a structured verdict with reasons.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T12:43:03.944Z","isFirstParty":false,"canonicalSlug":"email-check-be6f32cf"}