REST API for Email & IP Lookup
Name | Type | Required | Description |
---|---|---|---|
string | Yes | Email address to lookup (in URL path) | |
key | string | Yes | Your API key (as query parameter) |
curl --location 'https://api.fraudo.io/v1/email/[email protected]?key=4c3b2cd9-8d1f-4564-807a-9d587f3e05ce'
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 |
{ "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 } }
{ "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." }
Name | Type | Required | Description |
---|---|---|---|
ip | string | Yes | IPv4 address to lookup (in URL path) |
key | string | Yes | Your API key (as query parameter) |
curl --location 'https://api.fraudo.io/v1/122.162.147.105?key=4c3b2cd9-8d1f-4564-807a-9d587f3e05ce'
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 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 |
{ "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 } }
{ "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." }