Start here
Documentation
Integrate IronDome email checks with REST, JavaScript, Python, Go, Rust, or Supabase Auth. Learn authentication, quota, and signup handling.
On this page
IronDome detects disposable email addresses before you create an account or accept an email into your product. Call it from your server at https://api.irondome.dev.
Make your first check
Start with the quickstart to create an API key, submit an email, and apply the result.
A classification checks syntax and disposable-email rules. It does not verify mailbox existence, ownership, or delivery. Use an email verification link or code to confirm ownership.
Choose an integration
- JavaScript, Python, Go, and Rust: reusable server-side clients. The JavaScript SDK is available on npm.
- Supabase Auth: screen new users with a signed Before User Created hook.
- Edge and serverless: transports for Workers, Vercel, and Deno.
- REST: any HTTP client with Bearer authentication.
API reference
| Endpoint | Use |
|---|---|
| POST /v1/check | Classify one email |
| POST /v1/check/bulk | Classify up to 100 emails |
| GET /v1/usage | Read your free allowance |
| GET /healthz | Check availability without a credential |
Deploy your integration
Follow signup validation for account-creation decisions and connection reuse for client lifecycles. An unavailable check is not a classification.
Read authentication, plans and limits, and errors before enabling production traffic.