Single Lookup
This is the primary IpForensics endpoint. It is used to look up any given IPv4 or IPv6 addresses. To call this endpoint, simply attach an IP address to the API's base URL (HTTP GET method):
Each request to the single IP lookup endpoint consumes 1 token.
Code Snippet
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://ipforensics.net/api/v1/single?apikey=IPF-36ae36a6-4a32-4fae-a422-e45e70b0a515-X&ip_address=102.219.153.59',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var requestOptions = {
method: 'GET',
redirect: 'follow'
};
fetch("https://ipforensics.net/api/v1/single?apikey=IPF-36ae36a6-4a32-4fae-a422-e45e70b0a515-X&ip_address=102.219.153.59", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));var axios = require('axios');
var config = {
method: 'get',
url: 'https://ipforensics.net/api/v1/single?apikey=IPF-36ae36a6-4a32-4fae-a422-e45e70b0a515-X&ip_address=102.219.153.59',
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
import requests
url = "https://ipforensics.net/api/v1/single?apikey=IPF-36ae36a6-4a32-4fae-a422-e45e70b0a515-X&ip_address=102.219.153.59"
payload={}
response = requests.request("GET", url, data=payload)
print(response.text)
var client = new RestClient("https://ipforensics.net/api/v1/single?apikey=IPF-36ae36a6-4a32-4fae-a422-e45e70b0a515-X&ip_address=102.219.153.59");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);Sample Response
{
"status": true,
"code": 200,
"message": "Successful",
"meta_data": {
"ip": "102.219.153.59",
"type": "IPv4",
"hostname": null,
"asn": {
"asn": 36920,
"domain": "kkontech.com",
"organization": "Kkon Technologies Ltd",
"route": "102.219.153.0/24",
"type": "isp"
},
"geolocation": {
"calling_code": "234",
"capital": "Abuja",
"name": "Nigeria",
"code": "NG",
"city": "Lagos",
"emoji": "🇳🇬",
"emoji_unicode": "U+1F1F3 U+1F1EC",
"latitude": 6.44745,
"longitude": 3.39025,
"language": {
"name": "English",
"code": "en",
"native": "English"
},
"in_eu": false
},
"advanced-geolocation": {
"area": 923768,
"population": 211400704,
"population_density": 228.85,
"tld": ".ng",
"continent": {
"name": "Africa",
"code": "AF"
},
"region": {
"name": "Lagos",
"code": "NG-LA"
},
"languages": [
{
"code": "en",
"name": "English",
"native": "English"
},
{
"code": "ha",
"name": "Hausa",
"native": "Hausa"
},
{
"code": "yo",
"name": "Yoruba",
"native": "Èdè Yorùbá"
},
{
"code": "ig",
"name": "Igbo",
"native": "Igbo"
},
{
"code": "ff",
"name": "Fula",
"native": "Pulaar"
}
],
"borders": [
"BJ",
"CM",
"NE",
"TD"
]
},
"currency": {
"code": "NGN",
"name": "Nigerian Naira",
"name_native": "Nigerian Naira",
"plural": "Nigerian nairas",
"plural_native": "Nigerian nairas",
"symbol": "NGN",
"symbol_native": "₦"
},
"carrier": {
"name": null,
"mcc": null,
"mnc": null
},
"company": {
"domain": "kkontech.com",
"name": "FOB VI",
"type": "isp",
"network": "102.219.153.0/24"
},
"threat_detector": {
"is_abuser": true,
"is_attacker": false,
"is_bogon": false,
"is_cloud_provider": false,
"is_proxy": false,
"is_relay": false,
"is_tor": false,
"is_tor_exit": false,
"is_vpn": false,
"is_anonymous": false,
"is_threat": true
},
"time_zone": {
"id": "Africa/Lagos",
"abbreviation": "WAT",
"current_time": "2022-10-27T14:30:06+01:00",
"name": "West Africa Standard Time",
"offset": 3600,
"in_daylight_saving": false
},
"device_info": [
{
"header": "PostmanRuntime/7.29.2",
"name": "PostmanRuntime",
"type": "robot",
"version": "7.29.2",
"version_major": "7",
"device": {
"brand": "Postman",
"name": "Postman Runtime",
"type": "robot"
},
"engine": {
"name": "PostmanRuntime",
"type": "robot",
"version": "7.29.2",
"version_major": "7"
},
"os": {
"name": "Cloud",
"type": "cloud",
"version": null
}
}
],
"iata_icao_airport_codes": {
"comment": "airport codes of IATA airport code and ICAO airport code, names and locations",
"airport": {
"id": 4940,
"country_code": "NG",
"region_name": "Lagos",
"iata": "LOS",
"icao": "DNMM",
"airport": "Murtala Muhammed International Airport",
"latitude": "6.577370167",
"longitude": "3.321160078"
},
"all_airports": [
{
"id": 4937,
"country_code": "NG",
"region_name": "Bauchi",
"iata": "BCU",
"icao": "",
"airport": "Bauchi State Airport",
"latitude": "10.482833",
"longitude": "9.744"
},
{
"id": 4938,
"country_code": "NG",
"region_name": "Delta",
"iata": "QRW",
"icao": "DNSU",
"airport": "Warri Airport (Osubi Airport)",
"latitude": "5.59611",
"longitude": "5.81778"
},
{
"id": 4939,
"country_code": "NG",
"region_name": "Katsina",
"iata": "DKA",
"icao": "",
"airport": "Katsina Airport",
"latitude": "13.0078001",
"longitude": "7.660449982"
},
{
"id": 4940,
"country_code": "NG",
"region_name": "Lagos",
"iata": "LOS",
"icao": "DNMM",
"airport": "Murtala Muhammed International Airport",
"latitude": "6.577370167",
"longitude": "3.321160078"
},
{
"id": 4941,
"country_code": "NG",
"region_name": "Ondo",
"iata": "AKR",
"icao": "DNAK",
"airport": "Akure Airport",
"latitude": "7.246739864",
"longitude": "5.301010132"
},
{
"id": 4942,
"country_code": "NG",
"region_name": "Akwa Ibom",
"iata": "QUO",
"icao": "DNAI",
"airport": "Akwa Ibom International Airport",
"latitude": "4.8725",
"longitude": "8.093"
},
{
"id": 4943,
"country_code": "NG",
"region_name": "Kaduna",
"iata": "ZAR",
"icao": "DNZA",
"airport": "Zaria Airport",
"latitude": "11.1302",
"longitude": "7.68581"
},
{
"id": 4944,
"country_code": "NG",
"region_name": "Sokoto",
"iata": "SKO",
"icao": "DNSO",
"airport": "Sadiq Abubakar III International Airport",
"latitude": "12.91629982",
"longitude": "5.207190037"
},
{
"id": 4945,
"country_code": "NG",
"region_name": "Adamawa",
"iata": "YOL",
"icao": "DNYO",
"airport": "Yola Airport",
"latitude": "9.25755024",
"longitude": "12.43039989"
},
{
"id": 4946,
"country_code": "NG",
"region_name": "Edo",
"iata": "BNI",
"icao": "DNBE",
"airport": "Benin Airport",
"latitude": "6.316979885",
"longitude": "5.599500179"
},
{
"id": 4947,
"country_code": "NG",
"region_name": "Gombe",
"iata": "GMO",
"icao": "DNGO",
"airport": "Gombe Lawanti International Airport",
"latitude": "10.29833333",
"longitude": "10.89638889"
},
{
"id": 4948,
"country_code": "NG",
"region_name": "Cross River",
"iata": "CBQ",
"icao": "DNCA",
"airport": "Margaret Ekpo International Airport",
"latitude": "4.976019859",
"longitude": "8.347200394"
},
{
"id": 4949,
"country_code": "NG",
"region_name": "Kaduna",
"iata": "KAD",
"icao": "DNKA",
"airport": "Kaduna Airport",
"latitude": "10.6960001",
"longitude": "7.320109844"
},
{
"id": 4950,
"country_code": "NG",
"region_name": "Enugu",
"iata": "ENU",
"icao": "DNEN",
"airport": "Akanu Ibiam International Airport",
"latitude": "6.474269867",
"longitude": "7.56196022"
},
{
"id": 4951,
"country_code": "NG",
"region_name": "Abuja Federal Capital Territory",
"iata": "ABV",
"icao": "DNAA",
"airport": "Nnamdi Azikiwe International Airport",
"latitude": "9.006790161",
"longitude": "7.263169765"
},
{
"id": 4952,
"country_code": "NG",
"region_name": "Rivers",
"iata": "PHC",
"icao": "DNPO",
"airport": "Port Harcourt International Airport",
"latitude": "5.015490055",
"longitude": "6.949590206"
},
{
"id": 4953,
"country_code": "NG",
"region_name": "Delta",
"iata": "ABB",
"icao": "DNAS",
"airport": "Asaba International Airport",
"latitude": "6.204167",
"longitude": "6.665278"
},
{
"id": 4954,
"country_code": "NG",
"region_name": "Niger",
"iata": "MXJ",
"icao": "DNMN",
"airport": "Minna Airport",
"latitude": "9.652170181",
"longitude": "6.462259769"
},
{
"id": 4955,
"country_code": "NG",
"region_name": "Borno",
"iata": "MIU",
"icao": "DNMA",
"airport": "Maiduguri International Airport",
"latitude": "11.85529995",
"longitude": "13.08090019"
},
{
"id": 4956,
"country_code": "NG",
"region_name": "Kwara",
"iata": "ILR",
"icao": "DNIL",
"airport": "Ilorin International Airport",
"latitude": "8.440210342",
"longitude": "4.493919849"
},
{
"id": 4957,
"country_code": "NG",
"region_name": "Rivers",
"iata": "PHG",
"icao": "",
"airport": "Port Harcourt City Airport",
"latitude": "4.846111111",
"longitude": "7.021388889"
},
{
"id": 4958,
"country_code": "NG",
"region_name": "Imo",
"iata": "QOW",
"icao": "DNIM",
"airport": "Sam Mbakwe Airport",
"latitude": "5.427060127",
"longitude": "7.206029892"
},
{
"id": 4959,
"country_code": "NG",
"region_name": "Kano",
"iata": "KAN",
"icao": "DNKN",
"airport": "Mallam Aminu Kano International Airport",
"latitude": "12.0476",
"longitude": "8.52462"
},
{
"id": 4960,
"country_code": "NG",
"region_name": "Benue",
"iata": "MDI",
"icao": "DNMK",
"airport": "Makurdi Airport",
"latitude": "7.70388",
"longitude": "8.61394"
},
{
"id": 4961,
"country_code": "NG",
"region_name": "Abuja Federal Capital Territory",
"iata": "JOS",
"icao": "DNJO",
"airport": "Yakubu Gowon Airport",
"latitude": "9.639829636",
"longitude": "8.869050026"
},
{
"id": 4962,
"country_code": "NG",
"region_name": "Oyo",
"iata": "IBA",
"icao": "DNIB",
"airport": "Ibadan Airport",
"latitude": "7.362460136",
"longitude": "3.978329897"
}
]
}
}
}Endpoint
Returns information about the current Ip address
GET https://ipforensics.net/api/v1/single?apikey=...&ip_address=...
Returns response object and a metadata of the request
Query Parameters
Name
Type
Description
apikey*
String
Your public key
ip_address*
String
Your private key
{
"status": true,
"code": 200,
"message": "Successful",
"meta_data": {
"ip": "102.219.153.59",
"type": "IPv4",
"hostname": null,
"asn": {
"asn": 36920,
"domain": "kkontech.com",
"organization": "Kkon Technologies Ltd",
"route": "102.219.153.0/24",
"type": "isp"
},
"geolocation": {
"calling_code": "234",
"capital": "Abuja",
"name": "Nigeria",
"code": "NG",
"city": "Lagos",
"emoji": "🇳🇬",
"emoji_unicode": "U+1F1F3 U+1F1EC",
"latitude": 6.44745,
"longitude": 3.39025,
"language": {
"name": "English",
"code": "en",
"native": "English"
},
"in_eu": false
},
"advanced-geolocation": {
"area": 923768,
"population": 211400704,
"population_density": 228.85,
"tld": ".ng",
"continent": {
"name": "Africa",
"code": "AF"
},
"region": {
"name": "Lagos",
"code": "NG-LA"
},
"languages": [
{
"code": "en",
"name": "English",
"native": "English"
},
{
"code": "ha",
"name": "Hausa",
"native": "Hausa"
},
{
"code": "yo",
"name": "Yoruba",
"native": "Èdè Yorùbá"
},
{
"code": "ig",
"name": "Igbo",
"native": "Igbo"
},
{
"code": "ff",
"name": "Fula",
"native": "Pulaar"
}
],
"borders": [
"BJ",
"CM",
"NE",
"TD"
]
},
"currency": {
"code": "NGN",
"name": "Nigerian Naira",
"name_native": "Nigerian Naira",
"plural": "Nigerian nairas",
"plural_native": "Nigerian nairas",
"symbol": "NGN",
"symbol_native": "₦"
},
"carrier": {
"name": null,
"mcc": null,
"mnc": null
},
"company": {
"domain": "kkontech.com",
"name": "FOB VI",
"type": "isp",
"network": "102.219.153.0/24"
},
"threat_detector": {
"is_abuser": true,
"is_attacker": false,
"is_bogon": false,
"is_cloud_provider": false,
"is_proxy": false,
"is_relay": false,
"is_tor": false,
"is_tor_exit": false,
"is_vpn": false,
"is_anonymous": false,
"is_threat": true
},
"time_zone": {
"id": "Africa/Lagos",
"abbreviation": "WAT",
"current_time": "2022-10-27T14:30:06+01:00",
"name": "West Africa Standard Time",
"offset": 3600,
"in_daylight_saving": false
},
"device_info": [
{
"header": "PostmanRuntime/7.29.2",
"name": "PostmanRuntime",
"type": "robot",
"version": "7.29.2",
"version_major": "7",
"device": {
"brand": "Postman",
"name": "Postman Runtime",
"type": "robot"
},
"engine": {
"name": "PostmanRuntime",
"type": "robot",
"version": "7.29.2",
"version_major": "7"
},
"os": {
"name": "Cloud",
"type": "cloud",
"version": null
}
}
],
"iata_icao_airport_codes": {
"comment": "airport codes of IATA airport code and ICAO airport code, names and locations",
"airport": {
"id": 4940,
"country_code": "NG",
"region_name": "Lagos",
"iata": "LOS",
"icao": "DNMM",
"airport": "Murtala Muhammed International Airport",
"latitude": "6.577370167",
"longitude": "3.321160078"
},
"all_airports": [
{
"id": 4937,
"country_code": "NG",
"region_name": "Bauchi",
"iata": "BCU",
"icao": "",
"airport": "Bauchi State Airport",
"latitude": "10.482833",
"longitude": "9.744"
},
{
"id": 4938,
"country_code": "NG",
"region_name": "Delta",
"iata": "QRW",
"icao": "DNSU",
"airport": "Warri Airport (Osubi Airport)",
"latitude": "5.59611",
"longitude": "5.81778"
},
{
"id": 4939,
"country_code": "NG",
"region_name": "Katsina",
"iata": "DKA",
"icao": "",
"airport": "Katsina Airport",
"latitude": "13.0078001",
"longitude": "7.660449982"
},
{
"id": 4940,
"country_code": "NG",
"region_name": "Lagos",
"iata": "LOS",
"icao": "DNMM",
"airport": "Murtala Muhammed International Airport",
"latitude": "6.577370167",
"longitude": "3.321160078"
},
{
"id": 4941,
"country_code": "NG",
"region_name": "Ondo",
"iata": "AKR",
"icao": "DNAK",
"airport": "Akure Airport",
"latitude": "7.246739864",
"longitude": "5.301010132"
},
{
"id": 4942,
"country_code": "NG",
"region_name": "Akwa Ibom",
"iata": "QUO",
"icao": "DNAI",
"airport": "Akwa Ibom International Airport",
"latitude": "4.8725",
"longitude": "8.093"
},
{
"id": 4943,
"country_code": "NG",
"region_name": "Kaduna",
"iata": "ZAR",
"icao": "DNZA",
"airport": "Zaria Airport",
"latitude": "11.1302",
"longitude": "7.68581"
},
{
"id": 4944,
"country_code": "NG",
"region_name": "Sokoto",
"iata": "SKO",
"icao": "DNSO",
"airport": "Sadiq Abubakar III International Airport",
"latitude": "12.91629982",
"longitude": "5.207190037"
},
{
"id": 4945,
"country_code": "NG",
"region_name": "Adamawa",
"iata": "YOL",
"icao": "DNYO",
"airport": "Yola Airport",
"latitude": "9.25755024",
"longitude": "12.43039989"
},
{
"id": 4946,
"country_code": "NG",
"region_name": "Edo",
"iata": "BNI",
"icao": "DNBE",
"airport": "Benin Airport",
"latitude": "6.316979885",
"longitude": "5.599500179"
},
{
"id": 4947,
"country_code": "NG",
"region_name": "Gombe",
"iata": "GMO",
"icao": "DNGO",
"airport": "Gombe Lawanti International Airport",
"latitude": "10.29833333",
"longitude": "10.89638889"
},
{
"id": 4948,
"country_code": "NG",
"region_name": "Cross River",
"iata": "CBQ",
"icao": "DNCA",
"airport": "Margaret Ekpo International Airport",
"latitude": "4.976019859",
"longitude": "8.347200394"
},
{
"id": 4949,
"country_code": "NG",
"region_name": "Kaduna",
"iata": "KAD",
"icao": "DNKA",
"airport": "Kaduna Airport",
"latitude": "10.6960001",
"longitude": "7.320109844"
},
{
"id": 4950,
"country_code": "NG",
"region_name": "Enugu",
"iata": "ENU",
"icao": "DNEN",
"airport": "Akanu Ibiam International Airport",
"latitude": "6.474269867",
"longitude": "7.56196022"
},
{
"id": 4951,
"country_code": "NG",
"region_name": "Abuja Federal Capital Territory",
"iata": "ABV",
"icao": "DNAA",
"airport": "Nnamdi Azikiwe International Airport",
"latitude": "9.006790161",
"longitude": "7.263169765"
},
{
"id": 4952,
"country_code": "NG",
"region_name": "Rivers",
"iata": "PHC",
"icao": "DNPO",
"airport": "Port Harcourt International Airport",
"latitude": "5.015490055",
"longitude": "6.949590206"
},
{
"id": 4953,
"country_code": "NG",
"region_name": "Delta",
"iata": "ABB",
"icao": "DNAS",
"airport": "Asaba International Airport",
"latitude": "6.204167",
"longitude": "6.665278"
},
{
"id": 4954,
"country_code": "NG",
"region_name": "Niger",
"iata": "MXJ",
"icao": "DNMN",
"airport": "Minna Airport",
"latitude": "9.652170181",
"longitude": "6.462259769"
},
{
"id": 4955,
"country_code": "NG",
"region_name": "Borno",
"iata": "MIU",
"icao": "DNMA",
"airport": "Maiduguri International Airport",
"latitude": "11.85529995",
"longitude": "13.08090019"
},
{
"id": 4956,
"country_code": "NG",
"region_name": "Kwara",
"iata": "ILR",
"icao": "DNIL",
"airport": "Ilorin International Airport",
"latitude": "8.440210342",
"longitude": "4.493919849"
},
{
"id": 4957,
"country_code": "NG",
"region_name": "Rivers",
"iata": "PHG",
"icao": "",
"airport": "Port Harcourt City Airport",
"latitude": "4.846111111",
"longitude": "7.021388889"
},
{
"id": 4958,
"country_code": "NG",
"region_name": "Imo",
"iata": "QOW",
"icao": "DNIM",
"airport": "Sam Mbakwe Airport",
"latitude": "5.427060127",
"longitude": "7.206029892"
},
{
"id": 4959,
"country_code": "NG",
"region_name": "Kano",
"iata": "KAN",
"icao": "DNKN",
"airport": "Mallam Aminu Kano International Airport",
"latitude": "12.0476",
"longitude": "8.52462"
},
{
"id": 4960,
"country_code": "NG",
"region_name": "Benue",
"iata": "MDI",
"icao": "DNMK",
"airport": "Makurdi Airport",
"latitude": "7.70388",
"longitude": "8.61394"
},
{
"id": 4961,
"country_code": "NG",
"region_name": "Abuja Federal Capital Territory",
"iata": "JOS",
"icao": "DNJO",
"airport": "Yakubu Gowon Airport",
"latitude": "9.639829636",
"longitude": "8.869050026"
},
{
"id": 4962,
"country_code": "NG",
"region_name": "Oyo",
"iata": "IBA",
"icao": "DNIB",
"airport": "Ibadan Airport",
"latitude": "7.362460136",
"longitude": "3.978329897"
}
]
}
}
}Last updated
Was this helpful?