canonical: https://jentic.com/apis/emailverifierapi.com/emailverifierapi # Email Verifier API Jentic publishes the only available OpenAPI specification for Email Verifier API, keeping it validated and agent-ready. Email Verifier API performs syntax checks, MX record lookups, disposable address detection, and SMTP-level mailbox verification on individual addresses or batches. Results indicate whether an address is deliverable, risky, or invalid, with a confidence signal usable in form gates and list hygiene jobs. Use it before pushing new sign-ups to your sending platform or before re-engaging an aged list. ## For AI agents Verify whether an email address is deliverable through syntax, MX, disposable, and mailbox checks, individually or in bulk. ## Scope Does not handle email sending, contact storage, or marketing automation - use for email address verification only. ## Capabilities - Verify a single email address with syntax, domain, and mailbox checks in one call - Submit a batch of addresses for bulk verification and read aggregate deliverability scores - Detect disposable, role-based, and free webmail addresses to filter sign-up forms - Confirm MX records exist for the address domain before accepting a registration - Score addresses as deliverable, risky, or undeliverable to drive list segmentation ## Use cases ### Sign-Up Form Email Gating Validate an email address inline at sign-up so disposable, mistyped, or undeliverable addresses never enter the user database. The API returns a single JSON object with deliverability status and category flags such as disposable or role. Product teams use this to cut bounce rates on welcome emails and reduce noise in product analytics. Example prompt: POST /v2 with the candidate email and an apiKey query parameter, then accept the sign-up only when the response indicates a deliverable, non-disposable address. ### Bulk List Hygiene Run a CSV of historical contacts through bulk verification to remove undeliverable and risky addresses before a re-engagement campaign. The bulk endpoint accepts the list and returns per-address verdicts so the sender list can be filtered to deliverable addresses only. Marketing operations teams typically run this monthly or before major sends to protect sender reputation. Example prompt: POST `/v2/bulk` with the array of addresses and partition the response into deliverable, risky, and undeliverable buckets. ### Disposable Address Detection Reject disposable inbox providers at the point of sign-up to discourage abuse on free trials and gated downloads. The single-verify endpoint surfaces a disposable flag alongside its main deliverability verdict. Growth and trust teams enforce this on free-tier flows where one user per address matters. Example prompt: POST /v2 for the address, read the disposable flag, and surface a 'use a permanent email' error when it is true. ### Agent-Driven Verification at Form Submission An agent inside an onboarding workflow takes the user-provided email, verifies it through Email Verifier API, and writes the verdict back to the customer record so downstream emails can be conditionally routed. Through Jentic the agent searches by intent, loads the schema, and executes the call without a hand-coded client. Integration takes under an hour rather than a day of bespoke wiring. Example prompt: Search Jentic for 'verify an email address', execute POST /v2 with the address, and update the customer record with the deliverability verdict. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/v2` | Verify a single email address | | POST | `/v2/bulk` | Verify a batch of email addresses | ## Key resources - **Email Verification** — Verify a single address with syntax, MX, and mailbox checks - **Bulk Verification** — Submit batches of addresses and read per-address verdicts ## Why Jentic - **Setup:** Wiring Email Verifier API by hand means handling its API key passed as a query parameter, formatting single and bulk verification calls, and managing your own retries against https://emailverifierapi.com. Through Jentic you install once, import Email Verifier API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Email Verifier API works through two POST operations (/v2 for a single address and `/v2/bulk` for a list) with no resource id in the URL path, so scope it by operation: limit the agent to the operations it needs, such as single-address verification, and leave bulk verification out of the allowed set unless you add it. - **Credential handling:** Your Email Verifier API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'check if an email address is deliverable' or 'verify a list of addresses', and Jentic returns the matching Email Verifier operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **ZeroBounce API** — Email validation with deliverability scoring and abuse detection - **Kickbox API** — Real-time email verification with Sendex quality score - **NeverBounce API** — Email list cleaning and verification at scale - **SparkPost API** — Send to verified addresses through a deliverability-focused ESP ## FAQ ### Why is there no official OpenAPI spec for Email Verifier API? Email Verifier API does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Email Verifier API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Email Verifier API use? The API uses an API key passed as the apiKey query parameter on each request. Through Jentic, the key is stored encrypted in the vault and the agent never sees it directly - Jentic injects it at execution time. ### Can I verify multiple addresses in a single call with the Email Verifier API? Yes. POST `/v2/bulk` accepts an array of addresses and returns per-address verdicts in one response, which is the recommended path for list hygiene jobs. ### How do I verify a sign-up email through Jentic? Search Jentic with the query 'verify an email address', load the schema for POST /v2, and execute it with the candidate address. Jentic injects the API key, so the agent reads only the deliverability verdict. ### What are the rate limits for the Email Verifier API? The OpenAPI spec does not declare quantitative rate limits; limits are enforced by plan tier on emailverifierapi.com. Treat HTTP 429 responses as authoritative and back off using the Retry-After header where present. ### Does the Email Verifier API detect disposable addresses? Yes. POST /v2 returns category flags including disposable and role-based, so sign-up flows can reject temporary inbox providers before the account is created. ### Can I limit what my agent is allowed to do with the Email Verifier API? Yes. Because you run Jentic One yourself, your own rules decide which Email Verifier API operations and credentials the agent may use. This API exposes just two operations, single-address verification at POST /v2 and bulk verification at POST `/v2/bulk`, so you can scope by operation: allow only single-address verification and leave bulk verification out of the agent's permitted set. The stored API key is injected at execution time under those same rules, so the agent can call only what you have approved.