Email Verification API

An Email Verification API validates whether an email address is properly formatted, active, and capable of receiving emails. It helps businesses reduce fake registrations, improve email delivery rates, and maintain accurate customer data.

API Details

Request URL

POST

https://g99.in/api/public/check/email

Request Body Parameters

Type	Name	Optional	Description
String	EmailID	Required	The Email Address.

Sample Request Payload

request.json

{
  "EmailID": "test@gmail.com"
}

Request Header Parameters

Type	Name	Value / Description	Optional
String	Content-Type	application/json	Required

Sample Code

request.php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://g99.in/api/public/check/email',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "EmailID": "test@gmail.com"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

request.py

import requests
import json

url = "https://g99.in/api/public/check/email"

payload = json.dumps({
  "EmailID": "test@gmail.com"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

request.cs

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://g99.in/api/public/check/email");
var content = new StringContent("{\r\n  \"EmailID\": \"test@gmail.com\"\r\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

HTTP status code 200

Key	Type	Description
email	String	The email address that was verified.
disposable	String	Indicates whether the email belongs to a temporary/disposable email service.
role	String	Indicates whether the email is a role-based address like admin, support, or info.
deliverable	String	Shows whether the email can successfully receive emails.
risk	String	Risk level associated with the email based on fraud or spam analysis.
tags	String	Additional labels or classifications related to the email verification result.
smtp	String	Indicates whether the SMTP server for the email is reachable and valid.
score	String	Verification confidence score representing the quality and reliability of the email.
suggestion	String	Recommended correction if the email appears misspelled or invalid.
valid	Boolean	Indicates whether the email address is considered valid overall.

Sample Response

Sample response for valid document

response.json

{
    "email": "test@gmail.com",
    "disposable": false,
    "role": false,
    "deliverable": "SUCCESS",
    "risk": "LOW",
    "tags": [],
    "smtp": true,
    "score": 90,
    "suggestion": null,
    "valid": true
}

Error Response

Parameter	Type	Description
status	Number	Unique error codes for different errors. Always available.
message	String	Error message describing the error. Always Available.
error	Boolean	True / False for different errors. Always available.

Error Codes

HTTP Status	Error Code	Error Message
400	4001	Malformed data or missing required parameter values.
400	4002	Invalid Email Format.
503	5001	Request could not be processed. Please try again later.

Sample Error Response

response.json

{
  "message": "Malformed data or missing required parameter values.",
  "status": 4001,
  "error": True
}