Catch fake and mistyped emails at sign-up.

How it works

Check on your server, as the form is sent.

1. Take the address

   When the form is posted, take the email on your server. Don't call the API from the browser: your key would be public.

2. Ask about it

   Send it to POST /verify. Our verification servers ask its mail server whether the mailbox exists. No email is sent.

3. Act on the verdict

   Let valid addresses in. Ask about a typo for invalid ones. Let the rest in, and confirm by email.

4. Don't wait forever

   Some mail servers are slow. Give the call a time limit, and let the sign-up through if it runs out.

Preview

What the check looks like from your server.

This is how the API is planned to work. Names and fields may change before launch.

curl https://api.magpie-cloud.com/v1/verify \
  -H "Authorization: Bearer $MAGPIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "alex.sample@examplefreight.example" }'

const res = await fetch("https://api.magpie-cloud.com/v1/verify", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MAGPIE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "alex.sample@examplefreight.example" }),
});
const data = await res.json();

import os
import requests

res = requests.post(
    "https://api.magpie-cloud.com/v1/verify",
    json={"email": "alex.sample@examplefreight.example"},
    headers={"Authorization": f"Bearer {os.environ['MAGPIE_API_KEY']}"},
    timeout=90,
)
data = res.json()

{
  "email": "alex.sample@examplefreight.example",
  "verdict": "valid",
  "summary": "The mail server says this mailbox exists.",
  "checks": {
    "syntax": true,
    "domain": true,
    "mailbox": "exists",
    "disposable": false,
    "role": false,
    "free": false,
    "provider": null
  }
}

Early access

Get a key when it's ready.

The APIs aren't live yet. Tell us what you need, and we'll write when keys are ready.

Keep exploring

Related