GET
https://api.fraudo.io/v1/email/{email}?key={api_key}
Lookup information about an email address. Returns details such as validity, disposable status, DNS,
domain age, and more.
Request Parameters
Name
Type
Required
Description
email
string
Yes
Email address to lookup (in URL path)
key
string
Yes
Your API key (as query parameter)
Example Request
curl --location 'https://api.fraudo.io/v1/email/[email protected] ?key=4c3b2cd9-8d1f-4564-807a-9d587f3e05ce'
Copy
Response Fields
Field
Type
Description
status
string
Status of the request ("ok" or "error").
If "error", check the error message for details.
message
string
Error message if status is "error".
Contains details about the issue (e.g., Invalid email).
data.id
string
Unique request ID
data.email
string
The queried email address
data.valid
boolean
Is the email valid?
data.disposable
boolean
Is it a disposable email?
data.dns_valid
boolean
Is the domain DNS valid?
data.domain_age
object
Domain age info (human, timestamp, iso)
data.sanitized_email
string
Sanitized email address
data.spf_record
boolean
SPF record present?
data.dmarc_record
boolean
DMARC record present?
data.mx_records
array
MX records for domain
data.a_records
array
A records for domain
data.lookup_left
integer
Remaining lookups for your API key
Example Response
{
"status": "ok",
"data": {
"id": "pnhDQ2HPdF",
"email": "[email protected] ",
"valid": true,
"disposable": true,
"dns_valid": true,
"domain_age": {
"human": "3 years ago",
"timestamp": 1651600945,
"iso": "2022-05-03T23:32:25+05:30"
},
"sanitized_email": "[email protected] ",
"spf_record": false,
"dmarc_record": false,
"mx_records": [
"prd-smtp.10minutemail.com"
],
"a_records": [
"159.25.16.14"
],
"lookup_left": 151539
}
}
Error Response
{
"status": "error",
"message": "The API key you provided is invalid or does not exist in our records. Please double-check your API credentials and try again. If you do not have an API key, please register for an account or contact support for assistance."
}
GET
https://api.fraudo.io/v1/{ip}?key={api_key}
Lookup geolocation, network, risk, and provider information for an IPv4 address.
Request Parameters
Name
Type
Required
Description
ip
string
Yes
IPv4 address to lookup (in URL path)
key
string
Yes
Your API key (as query parameter)
Example Request
curl --location 'https://api.fraudo.io/v1/122.162.147.105?key=4c3b2cd9-8d1f-4564-807a-9d587f3e05ce'
Copy
Response Fields
Field Type Description
status
string
Status of the request ("ok" or "error").
{ip}.network.asn
string
Autonomous System Number
{ip}.network.range
string
IP range (CIDR format)
{ip}.network.hostname
string
Reverse DNS hostname
{ip}.network.provider
string
Network provider name
{ip}.network.organisation
string
Organisation using the network
{ip}.network.type
string
Connection type (e.g., Hosting, ISP, Mobile)
{ip}.location.continent_name
string
Continent name
{ip}.location.continent_code
string
Continent code (e.g., EU, AS)
{ip}.location.country_name
string
Country name
{ip}.location.country_code
string
ISO country code
{ip}.location.region_name
string
Region or state name
{ip}.location.region_code
string
Region code
{ip}.location.city_name
string
City name
{ip}.location.postal_code
string
Postal code
{ip}.location.latitude
float
Latitude
{ip}.location.longitude
float
Longitude
{ip}.location.timezone
string
Timezone
{ip}.location.currency.name
string
Currency name
{ip}.location.currency.code
string
Currency ISO code
{ip}.location.currency.symbol
string
Currency symbol
{ip}.device_estimate.address
integer
Estimated number of addresses in subnet
{ip}.device_estimate.subnet
integer
Estimated subnet size
{ip}.detections.proxy
boolean
Whether IP is detected as proxy
{ip}.detections.vpn
boolean
Whether IP is detected as VPN
{ip}.detections.compromised
boolean
Whether IP is compromised
{ip}.detections.scraper
boolean
Whether IP is used by scraper
{ip}.detections.tor
boolean
Whether IP belongs to TOR network
{ip}.detections.hosting
boolean
Whether IP is a hosting provider
{ip}.detections.anonymous
boolean
Whether IP belongs to an anonymous source
{ip}.detections.risk
integer
Risk score (0–100)
{ip}.last_updated
integer (UNIX timestamp)
When this IP record was last updated
query_time
integer
Processing time of the query (ms)
Example Response
{
"status": "ok",
"122.162.147.105": {
"network": {
"asn": "AS24560",
"range": "122.162.147.105/29",
"hostname": "abts-north-dynamic-105.147.162.122.airtelbroadband.in",
"provider": "Bharti Airtel Limited",
"organisation": "Abts Delhi",
"type": "Wireless"
},
"location": {
"continent_name": "Asia",
"continent_code": "AS",
"country_name": "India",
"country_code": "IN",
"region_name": "Haryana",
"region_code": "HR",
"city_name": "Gurugram",
"postal_code": "Unknown",
"latitude": 28.4601,
"longitude": 77.0264,
"timezone": "Asia/Kolkata",
"currency": {
"name": "Rupee",
"code": "INR",
"symbol": "₹"
}
},
"device_estimate": {
"address": 1,
"subnet": 250
},
"detections": {
"proxy": false,
"vpn": false,
"compromised": false,
"scraper": false,
"tor": false,
"hosting": false,
"anonymous": false,
"risk": 0
},
"last_updated": 1757869191
},
"query_time": 3
}
Error Response
{
"status": "error",
"message": "The API key you provided is invalid or does not exist in our records. Please double-check your API credentials and try again. If you do not have an API key, please register for an account or contact support for assistance."
}