Getting Started

Get up and running with Mailsniper API in 5 minutes. Follow these simple steps to make your first email validation request.

Get Your API Key

First, you'll need an API key to authenticate your requests. This is your unique identifier for accessing Mailsniper.

How to get your API key:

1. Sign up for a free account
2. Verify your email address
3. Create your first API key from the dashboard

Keep your API key secure

Never expose your API key in client-side code or public repositories. Always use it from your backend servers.

Make Your First Request

The main endpoint is /v1/verify/email/{email}. It validates an email address and returns detailed information about the domain.

Request Format

Endpoint: GET https://api.mailsniperapp.com/v1/verify/email/{email}

Authentication: Bearer token in Authorization header

Required Parameter: email - The email address to validate

Choose Your Language

curl -X GET \
  "https://api.mailsniperapp.com/v1/verify/email/[email protected]" \
  -H "Authorization: Bearer <API-KEY-HERE>"

Run this in your terminal (Linux/Mac) or command prompt (Windows with curl installed).

const response = await fetch(
  'https://api.mailsniperapp.com/v1/verify/email/[email protected]',
  {
    headers: {
      'Authorization': 'Bearer <API-KEY-HERE>'
    }
  }
);

const data = await response.json();
console.log(data);

Save as test.js and run with node test.js (requires Node.js).

import requests

response = requests.get(
    'https://api.mailsniperapp.com/v1/verify/email/[email protected]',
    headers={
        'Authorization': 'Bearer <API-KEY-HERE>'
    }
)

print(response.json())

Save as test.py and run with python test.py (requires requests: pip install requests).

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,
    'https://api.mailsniperapp.com/v1/verify/email/[email protected]');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <API-KEY-HERE>'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Save as test.php and run with php test.php.

Replace your API key

Make sure to replace <API-KEY-HERE> with your full API key from the dashboard.

Understanding the Response

The API returns a JSON response with detailed information about the email domain. Here's what you'll get:

{
  "email": "[email protected]",
  "user": "user",
  "domain": "10minutemail.com",
  "is_valid": true,
  "is_disposable": true,
  "is_public_provider": false,
  "is_university": false,
  "is_catch_all": false,
  "is_spam": true,
  "risk": 100,
  "dns": {
    "mx_servers": ["mx1.10minutemail.com", "mx2.10minutemail.com"],
    "has_a_root_record": true
  }
}

Most Important Fields

is_disposable - True for temporary email services
is_spam - True for domains known for spam/abuse
risk - Overall risk assessment (low/medium/high)

Additional Information

is_public_provider - Gmail, Yahoo, Outlook, etc.
is_university - Educational institutions
is_catch_all - Accepts any email address

Learn about all response fields →

🎉 You're Ready to Go!

You now know how to make API requests and understand the responses. Here's what to explore next: