Validate Email API
The Validate Email API allows you to check whether a given email address is valid and return its metadata.
From 8,862 users
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 442ms | 463ms | 522ms | 858ms | 1156ms |
Didn't find what you were looking for? Suggest an improvement
/v1/validateemail GET
https://api.api-ninjas.com/v1/validateemail
Returns metadata (including whether it is valid) for a given email address. This API will check the formatting of the email and the existence of DNS records for the domain to make sure it is a valid email address.
Parameters
emailrequiredEmail address to validate.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
is_validbooleanWhether the email address is valid.
domainstringDomain of the email address.
emailstringEmail address.
mx_recordsbooleanWhether the domain has MX records.
is_disposablebooleanWhether the email address is disposable. We maintain a large database of hundreds of thousands of disposable domains and check against it for every email address.
main_categorystringThe main category (L1) of the email role based on its local part (prefix). See the Category Mappings table below for all possible values.
sub_categorystringThe sub-category (L2) of the email role based on its local part (prefix). See the Category Mappings table below for all possible values.
Email Role Category Mappings
The following table shows all possible email role categories and sub-categories based on the email prefix (local part).
Click to expand/collapse category mappings table
| Main Category | Sub-Category |
|---|---|
| technical_operations | smtp_mail_administration |
| dns_domain_administration | |
| web_server_administration | |
| network_operations | |
| customer_engagement | general_inquiries |
| sales_business_development | |
| customer_support | |
| billing_orders | |
| automated_transactional | noreply_unmonitored |
| notifications_alerts | |
| transactional_processing | |
| corporate_functions | human_resources |
| finance_accounting | |
| legal_contracts | |
| operations_facilities | |
| research_development | |
| security_compliance | abuse_incident_response |
| security_operations | |
| privacy_regulatory_compliance | |
| executive_leadership | csuite_executives |
| management_boards | |
| industry_specific | hospitality_travel |
| ecommerce_retail | |
| education | |
| healthcare_medical | |
| real_estate_property | |
| financial_services_banking | |
| media_publishing | |
| nonprofit_government | nonprofit_government |
| marketing_communications | press_media_relations |
| marketing_operations | |
| newsletter_content |
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v1/validateemail?email=info@api-ninjas.comHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
8
9
{
"is_valid": true,
"domain": "api-ninjas.com",
"email": "info@api-ninjas.com",
"mx_records": true,
"main_category": "customer_engagement",
"sub_category": "general_inquiries",
"is_disposable": false
}Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/validateemail?email=info@api-ninjas.com" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.