API Knowledge Base - ValidEmail

Main

Developer Knowledge Base

Email Verification API Guide

Everything in one place: endpoint format, quick integration snippets in popular languages, and a complete response field reference.

Method: GET Base URL: https://api.ValidEmail.net/ 1 credit per verification

Quick request

https://api.ValidEmail.net/?email=EMAIL_ADDRESS&token=YOUR_API_KEY

Replace EMAIL_ADDRESS and YOUR_API_KEY with your real values, or sign in to view your live test URL.

Language Examples

Based on existing API docs for C#, Go, Java, JavaScript, PHP, Python, and Ruby.

C#

HttpClient

var url = $"https://api.ValidEmail.net/?email={email}&token={token}";
var response = await client.GetAsync(url);
var result = JsonConvert.DeserializeObject<Response>(await response.Content.ReadAsStringAsync());

Go

net/http

url := fmt.Sprintf("https://api.ValidEmail.net/?email=%s&token=%s", email, token)
resp, err := http.Get(url)
json.NewDecoder(resp.Body).Decode(&result)

Java

HttpURLConnection

String apiUrl = "https://api.ValidEmail.net/?email=" + email + "&token=" + token;
HttpURLConnection connection = (HttpURLConnection) new URL(apiUrl).openConnection();
int responseCode = connection.getResponseCode();

JavaScript (Node.js)

axios

const url = `https://api.ValidEmail.net/?email=${email}&token=${token}`;
const response = await axios.get(url);
console.log(response.data.IsValid, response.data.Score);

PHP

file_get_contents

$url = "https://api.ValidEmail.net/?email={$email}&token={$token}";
$response = file_get_contents($url);
$data = json_decode($response, true);

Python

requests

url = f"https://api.ValidEmail.net/?email={email}&token={token}"
response = requests.get(url)
result = response.json()

Ruby

net/http

uri = URI("https://api.ValidEmail.net/?email=#{email}&token=#{token}")
response = Net::HTTP.get_response(uri)
data = JSON.parse(response.body)

Response Guide

Use these fields to make reliable delivery decisions in your product workflow.

{
  "IsValid": true,
  "Score": 95,
  "Email": "validemailnet@gmail.com",
  "State": "Deliverable",
  "Reason": "ACCEPTED EMAIL",
  "Domain": "gmail.com",
  "Free": true,
  "Role": false,
  "Disposable": false,
  "AcceptAll": false,
  "Tag": false,
  "MXRecord": "gmail-smtp-in.l.google.com.",
  "EmailAdditionalInfo": []
}

Field	Type	Description
IsValid	boolean	Overall validation status.
Score	integer (0-100)	Confidence score. Recommended threshold: 80+.
Email	string	The exact queried email address.
State	string	Deliverable or Not Deliverable.
Reason	string	Primary SMTP/validation reason.
Domain	string	Extracted domain from the email.
Free	boolean	True when provider is free (e.g., Gmail).
Role	boolean	True for role inboxes (info, support, admin).
Disposable	boolean	True for temporary/disposable addresses.
AcceptAll	boolean	True when domain accepts all recipients.
Tag	boolean	True for tagged aliases (user+tag@domain).
MXRecord	string	Resolved mail exchange server.
EmailAdditionalInfo	array	Reserved metadata collection.

Best practice: Send only to emails where IsValid = true, prefer Score >= 80, and avoid spam traps for better campaign performance.