Fraudo.io

AI-Driven IP & Email Threat Intelligence by fraudo.io

REST API for Email & IP Lookup

Email Lookup Endpoint

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'
                
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."
}
                

IP Lookup Endpoint

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'
                
Response Fields
FieldTypeDescription
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."
}