Quickstart

Verify your first email address in a few minutes.

1. Get an API key. In the dashboard, open API keys and create a key. Copy the secret key (it starts with sk_) — you won’t be able to see it again.

2. Make a verification request. Replace sk_your_api_key with your key:

   cURL

   curl "https://api.verifymaill.com/v1/verify?email=jane@example.com" \
     -H "Authorization: Bearer sk_your_api_key"

   Node.js

   const res = await fetch(
     "https://api.verifymaill.com/v1/verify?email=jane@example.com",
     { headers: { Authorization: "Bearer sk_your_api_key" } },
   );
   const result = await res.json();
   console.log(result.status, result.score);

   Python

   import requests
   
   res = requests.get(
       "https://api.verifymaill.com/v1/verify",
       params={"email": "jane@example.com"},
       headers={"Authorization": "Bearer sk_your_api_key"},
   )
   result = res.json()
   print(result["status"], result["score"])

3. Read the response.

   {
     "email": "jane@example.com",
     "status": "deliverable",
     "sub_status": null,
     "score": 96,
     "disposable": false,
     "role": false,
     "free": false,
     "accept_all": false
   }

   See Understanding results for what each field means.

Next steps

• Authentication — keys, headers, environments
• Verify a single email — full endpoint reference
• Bulk jobs — verify lists at scale
• SDKs & libraries — official clients