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
NameTypeRequiredDescription
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
FieldTypeDescription
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
NameTypeRequiredDescription
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").
If "error", check the error message for details.
message string Error message if status is "error".
Contains details about the issue (e.g., Invalid IP).
data.id string Unique request ID
data.ip string The queried IP address
data.asn string Autonomous System Number
data.provider string Network provider
data.organisation string Organisation name
data.continent string Continent name
data.continent_code string Continent code
data.country string Country name
data.isocode string Country ISO code
data.region string Region or state
data.region_code string Region code
data.timezone string Timezone
data.city string City
data.postcode string/null Postal code
data.latitude float Latitude
data.longitude float Longitude
data.currency_code string Currency code
data.currency_name string Currency name
data.currency_symbol string Currency symbol
data.proxy string Proxy status ("yes"/"no")
data.type string Connection type
data.risk integer Risk score (0-100)
data.lookup_left integer Remaining lookups for your API key
Example Response
{
    "status": "ok",
    "data": {
        "id": "ZSPpnM3KSm",
        "ip": "122.162.147.105",
        "asn": "AS24560",
        "provider": "Bharti Airtel Limited",
        "organisation": "Abts Delhi",
        "continent": "Asia",
        "continent_code": "AS",
        "country": "India",
        "isocode": "IN",
        "region": "Delhi",
        "region_code": "DL",
        "timezone": "Asia/Kolkata",
        "city": "Hashtsāl",
        "postcode": null,
        "latitude": 28.6341,
        "longitude": 77.0577,
        "currency_code": "INR",
        "currency_name": "Rupee",
        "currency_symbol": "₹",
        "proxy": "no",
        "type": "Wireless",
        "risk": 0,
        "lookup_left": 151639
    }
}
                
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."
}