Easy Email API Documentation

Welcome to the official documentation for the Email Verification API. This guide provides detailed instructions to help you integrate and use the API effectively.

Overview

The Easy Email Verification API is designed to validate email addresses in real-time. It provides information about the validity, deliverability, and attributes of email addresses to ensure a clean and reliable user database.

Features

• Email Validation: Check if an email address is formatted correctly.
• Domain Analysis: Validate if the domain of the email is active and has proper DNS records.
• Disposable Email Detection: Identify temporary email addresses.
• Free Email Detection: Identify email addresses using a free email provider like gmail.com
• Role-Based Email Detection: Detect emails associated with roles like [email protected].
• Inbox Existence Check: Confirm if the email inbox exists.
• Confidence Scoring: Assess the reliability of the email address.

Quick Start

Replace {email} with the email address you want to validate.

Example Request

GET http://easyemailapi.com/api/verify/[email protected]

Response Format

The API returns a JSON response with the following structure:

{
  "email": "[email protected]",
  "valid": true,
  "user": "tcook",
  "domain": "apple.com",
  "role": false,
  "disposable": false,
  "free_email": false,
  "valid_mx": true,
  "mx": "",
  "sub": false,
  "score": 100,
  "inbox_exists": true
}

Response Parameters

Error Codes

Rate Limiting

The FREE plan is limited to 10 requests per minute to ensure fair usage and the stability of the service.

Need More Requests?

If your application requires a higher allocation, we’re here to help! Please reach out to us to discuss customized plans that suit your needs.

Contact us at [email protected] or visit our website for more information.

Integration Examples

cURL

curl -X GET "http://easyemailapi.com/api/verify/[email protected]"

JavaScript (Axios)

const axios = require("axios");

axios
  .get("http://easyemailapi.com/api/verify/[email protected]")
  .then((response) => console.log(response.data))
  .catch((error) => console.error(error));

JavaScript (Without Axios)

const email = "[email protected]";
const url = `http://easyemailapi.com/api/verify/${email}`;

fetch(url)
  .then((response) => {
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
  })
  .then((data) => {
    console.log(data);
  })
  .catch((error) => {
    console.error("Error:", error);
  });

Python

import requests

email = "[email protected]"
url = f"http://easyemailapi.com/api/verify/{email}"

response = requests.get(url)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")

PHP

<?php

$email = "[email protected]";
$url = "http://easyemailapi.com/api/verify/" . urlencode($email);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

if ($response === false) {
    echo "Error: " . curl_error($ch);
} else {
    $data = json_decode($response, true);
    print_r($data);
}

curl_close($ch);

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$email = "[email protected]";
$url = "http://easyemailapi.com/api/verify/{$email}";

$response = Http::get($url);

if ($response->successful()) {
    $data = $response->json();
    print_r($data);
} else {
    echo "Error: " . $response->status();
}

PHP (Guzzle)

<?php

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$email = "[email protected]";
$url = "http://easyemailapi.com/api/verify/{$email}";

$client = new Client();
$response = $client->request('GET', $url);

if ($response->getStatusCode() === 200) {
    $data = json_decode($response->getBody(), true);
    print_r($data);
} else {
    echo "Error: " . $response->getStatusCode();
}

Ruby

require 'net/http'
require 'json'

email = '[email protected]'
url = URI("http://easyemailapi.com/api/verify/#{email}")

response = Net::HTTP.get_response(url)

if response.is_a?(Net::HTTPSuccess)
  data = JSON.parse(response.body)
  puts data
else
  puts "Error: #{response.code}"
end

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        string email = "[email protected]";
        string url = $"http://easyemailapi.com/api/verify/{email}";

        using (HttpClient client = new HttpClient())
        {
            try
            {
                HttpResponseMessage response = await client.GetAsync(url);
                if (response.IsSuccessStatusCode)
                {
                    string responseBody = await response.Content.ReadAsStringAsync();
                    Console.WriteLine(responseBody);
                }
                else
                {
                    Console.WriteLine($"Error: {response.StatusCode}");
                }
            }
            catch (Exception e)
            {
                Console.WriteLine($"Exception: {e.Message}");
            }
        }
    }
}

Java

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class EmailVerification {
    public static void main(String[] args) {
        String email = "[email protected]";
        String urlString = "http://easyemailapi.com/api/verify/" + email;

        try {
            URL url = new URL(urlString);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("GET");

            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuilder response = new StringBuilder();

                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();
                System.out.println(response.toString());
            } else {
                System.out.println("Error: HTTP response code " + responseCode);
            }
        } catch (Exception e) {
            System.out.println("Exception: " + e.getMessage());
        }
    }
}