Email Lookup API

How It Works

The Email Lookup API is designed to validate email addresses with precision, determining their validity, activity status, and overall safety. This powerful service helps identify disposable, temporary, or high-risk emails, allowing you to ensure that the email addresses collected are legitimate and trustworthy. By integrating this API, you can enhance user verification processes, reduce fraud, and maintain the integrity of your platform.

Key Features:

• Domain and MX record verification.
• Identifies disposable and temporary emails.
• Validates syntax and checks for inactive or invalid emails.
• Provides risk scores and insights for email fraud detection.

Integration

Endpoint:

api/emaillookup

Method:

POST

Base URL:

https://api.boltidentity.com/

Request Headers

{
  "licenseKey": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body

The request must include the email address to be validated.

{
  "email": "example@example.com"
}

Example Request (Using Fetch)

const response = await fetch('https://api.boltidentity.com/api/emaillookup', {
    method: 'POST',
    headers: {
        'licenseKey': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        email: "example@example.com"
    })
});

const data = await response.json();

Sample Response

Understand Response

Field	Description	Possible Values / Example
status	Indicates the overall status of the email validation request.	Verified, Declined
message	Provides additional information about the status of the request.	"Email address is valid.", "Email validation Declined. High risk email detected"
response	Contains detailed analysis of the email address.	JSON object (see below)
aRecords	The list of IP addresses associated with the domain's DNS A records.	["64.233.185.17", "64.233.185.83", ...]
catchAll	Indicates if the domain accepts emails to all possible addresses.	true or false
common	Specifies whether the email belongs to a common domain (e.g., Gmail).	true or false
deliverability	Describes the likelihood of the email being successfully delivered.	high, medium, low
disposable	Indicates whether the email address is from a disposable provider.	true or false
dmarcRecord	Checks if the domain has a valid DMARC record.	true or false
dnsValid	Indicates if the domain's DNS records are valid.	true or false
domainAge	Details about how old the email's domain is.	"29 years ago", "808286400", "1995-08-13T00:00:00-04:00"
firstName	Extracted first name of the email owner, if available.	"John", "Unknown"
firstSeen	The first time this email address was detected.	"2 years ago", "1681924541", "2023-04-19T13:15:41-04:00"
fraudScore	A risk score indicating the likelihood of fraud.	Integer (0-100). Example: 80
frequentComplainer	Indicates frequent complaints.	true or false
generic	Indicates if the email is generic (e.g., support@, admin@).	true or false
honeypot	Identifies if the email is a honeypot.	true or false
leaked	Indicates if the email has appeared in data breaches.	true or false
mxRecords	Lists the mail exchange (MX) records for the domain.	["alt4.gmail-smtp-in.l.google.com", "gmail-smtp-in.l.google.com", ...]
overallScore	A combined score indicating the overall safety of the email.	Integer. Example: 4
recentAbuse	Indicates if the email was recently flagged for abuse.	true or false
riskyTld	Indicates if the domain’s TLD is considered risky.	true or false
sanitizedEmail	The cleaned-up version of the email.	"ajworking6789@gmail.com"
smtpScore	Indicates whether the SMTP server responded correctly.	Integer. Example: 3
spamTrapScore	Indicates if the email is a known spam trap.	"none", "low", "high"
spfRecord	Checks if the domain has a valid SPF record.	true or false
success	Indicates if the validation process was successful.	true or false
suggestedDomain	Suggests a possible correction for misspelled domains.	"gmail.com", "N/A"
suspect	Indicates if the email is flagged as suspicious.	true or false
timedOut	Indicates if the request timed out.	true or false
valid	Indicates if the email address is valid.	true or false