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;

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

{
    "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