Info Endpoint

Checks the provided IP address (both v4 & v6 formats) and returns all available information.

GET/v2/info

IP Information

This IP information endpoint returns information your client's or a specific IP address.

Optional attributes

Name
ip
Type
string
Description
The IP address you want to query
Name
language
Type
string
Description
An ISO Alpha 2 Language Code for localizing the IP data
Name
hostname
Type
boolean
Description
If the hostname parameter is set to 1, the API response will contain the hostname of the ip

Response Structure

Our /info endpoint offers the following information: data (general information), range_type, connection, location, tlds, timezone, security and domains.

Request

GET

/v2/info

curl -G https://api.ipbase.com/v2/info?ip=1.1.1.1 \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "data": {
        "ip": "1.1.1.1",
        "hostname": "one.one.one.one",
        "type": "v4",
        "range_type": {
            "type": "PUBLIC",
            "description": "Public address"
        },
        "connection": {
            "asn": 13335,
            "organization": "Cloudflare, Inc.",
            "isp": "APNIC Research and Development",
            "range": "1.1.1.1/32"
        },
        "location": {
            "geonames_id": 5368753,
            "latitude": 34.053611755371094,
            "longitude": -118.24549865722656,
            "zip": "90012",
            "continent": {
                "code": "NA",
                "name": "North America",
                "name_translated": "North America",
                "geonames_id": 6255149,
                "wikidata_id": "Q49"
            },
            "country": {
                "alpha2": "US",
                "alpha3": "USA",
                "calling_codes": [
                    "+1"
                ],
                "currencies": [
                    {
                        "symbol": "$",
                        "name": "US Dollar",
                        "symbol_native": "$",
                        "decimal_digits": 2,
                        "rounding": 0,
                        "code": "USD",
                        "name_plural": "US dollars"
                    }
                ],
                "emoji": "🇺🇸",
                "ioc": "USA",
                "languages": [
                    {
                        "name": "English",
                        "name_native": "English"
                    }
                ],
                "name": "United States",
                "name_translated": "United States",
                "timezones": [
                    "America/New_York",
                    "America/Detroit",
                    "America/Kentucky/Louisville",
                    "America/Kentucky/Monticello",
                    "America/Indiana/Indianapolis",
                    "America/Indiana/Vincennes",
                    "America/Indiana/Winamac",
                    "America/Indiana/Marengo",
                    "America/Indiana/Petersburg",
                    "America/Indiana/Vevay",
                    "America/Chicago",
                    "America/Indiana/Tell_City",
                    "America/Indiana/Knox",
                    "America/Menominee",
                    "America/North_Dakota/Center",
                    "America/North_Dakota/New_Salem",
                    "America/North_Dakota/Beulah",
                    "America/Denver",
                    "America/Boise",
                    "America/Phoenix",
                    "America/Los_Angeles",
                    "America/Anchorage",
                    "America/Juneau",
                    "America/Sitka",
                    "America/Metlakatla",
                    "America/Yakutat",
                    "America/Nome",
                    "America/Adak",
                    "Pacific/Honolulu"
                ],
                "is_in_european_union": false,
                "fips": "US",
                "geonames_id": 6252001,
                "hasc_id": "US",
                "wikidata_id": "Q30"
            },
            "city": {
                "fips": "0644000",
                "alpha2": null,
                "geonames_id": 5368753,
                "hasc_id": null,
                "wikidata_id": "Q65",
                "name": "Los Angeles",
                "name_translated": "Los Angeles"
            },
            "region": {
                "fips": "US06",
                "alpha2": "US-CA",
                "geonames_id": 5332921,
                "hasc_id": "US.CA",
                "wikidata_id": "Q99",
                "name": "California",
                "name_translated": "California"
            }
        },
        "tlds": [
            ".us"
        ],
        "timezone": {
            "id": "America/Los_Angeles",
            "current_time": "2023-06-28T07:46:37-07:00",
            "code": "PDT",
            "is_daylight_saving": true,
            "gmt_offset": -25200
        },
        "security": {
            "is_anonymous": false,
            "is_datacenter": false,
            "is_vpn": false,
            "is_bot": false,
            "is_abuser": false,
            "is_known_attacker": false,
            "is_proxy": false,
            "is_spam": false,
            "is_tor": false,
            "is_icloud_relay": false,
            "threat_score": 100
        },
        "domains": {
            "count": 12337,
            "domains": [
                "eliwise.academy",
                "accountingprose.academy",
                "1and1-test-ntlds-fr.accountant",
                "sulphur.africa",
                "saadeh.agency"
            ]
        }
    }
}

`data` Response Properties

Available in all plans

Name
ip
Type
string
Description
The requested IP address
Name
hostname
Type
string
Description
️The IPs hostname - if requested via ?hostname=1
Name
type
Type
string
Description
IP type v4 or v6

Hostname Lookup
The ipbase API does not by default return details about the hostname that the specified IP address resolves to. Add the hostname parameter of the API and set it to 1 to include the hostname object in your API return.

Important: The ipbase API does not by default return details about the hostname that the specified IP address resolves to. Add the hostname parameter of the API and set it to 1 to include the hostname object in your API return.

{
    "data": {
        "ip": "1.1.1.1",
        "hostname": "one.one.one.one",
        "type": "v4",
        ...
    }
}

`range_type` Response Properties

Available in all plans

Name
type
Type
string
Description
See below
Name
description
Type
string
Description
️Range type

The range type field can have the following values:

Name
UNSPECIFIED
Type
Description
Unspecified/unknown address
Name
RESERVED
Type
Description
️Reserved/internal use only
Name
THIS_NETWORK
Type
Description
️Refer to source hosts on this network
Name
LOOPBACK
Type
Description
️Internet host loopback address
Name
ANYCAST_RELAY
Type
Description
️Relay anycast address
Name
LIMITED_BROADCAST
Type
Description
️Limited broadcast destination address
Name
MULTICAST
Type
Description
️Multicast address assignments - Indentify a group of interfaces
Name
LINKLOCAL
Type
Description
️Link local address, allocated for communication between hosts on a single link
Name
LINKLOCAL_UNICAST
Type
Description
️Link local unicast / Linked-scoped unicast
Name
DISCARD_ONLY
Type
Description
️Discard only
Name
DISCARD
Type
Description
️Discard
Name
PRIVATE_NETWORK
Type
Description
️For use in private networks
Name
PUBLIC
Type
Description
️Public address
Name
CGNAT
Type
Description
️Carrier-grade NAT
Name
RESERVED
Type
Description
️Reserved/internal use only

{
    "range_type": {
        "type": "PUBLIC",
        "description": "Public address"
    }
}

`connection` Response Properties

Available in all plans

Name
asn
Type
integer
Description
The ASN number
Name
organization
Type
string
Description
️️The ASN organization
Name
isp
Type
string
Description
️️The name of the ISP
Name
range
Type
string
Description
The IP range

Tip: You can request more information about the ASN via the asn endpoint. The ASN endpoint is available in the medium plan and above.

{
    "connection": {
        "asn": 13335,
        "organization": "Cloudflare, Inc.",
        "isp": "APNIC Research and Development",
        "range": "1.1.1.1/32"
    }
}

`location` Response Properties

Available in all plans

Name
geonames_id
Type
integer
Description
Geonames identifier for the Geonames Registry
Name
latitude
Type
float
Description
️️Latitude associated with the IP address
Name
longitude
Type
float
Description
Longitude associated with the IP address
Name
zip
Type
string
Description
ZIP code associated with the IP address

Third-party data IDs

Our location information features IDs of the following data sources that can be mapped for further data ingestion:

Name
geonames_id
Type
source: Geonames
Description
Example: https://www.geonames.org/5332870/ for California
Name
hasc_id
Type
source: Wikidata
Description
Example: https://www.wikidata.org/wiki/Property:P8119 represents country subdivions within
Name
wikidata_id
Type
source: Wikidata
Description
Example: https://www.wikidata.org/wiki/Q30 for California
Name
fips
Type
source: FIPS
Description
https://www.census.gov/library/reference/code-lists/ansi.html

More detailed location data is available within three objects: country, city, and region.

`country`

Type: object

Name
alpha2
Type
string
Description
The alpha2 representation of the country code
Name
alpha3
Type
string
Description
️ The alpha3 representation of the country code
Name
calling_codes
Type
array<string>
Description
All available calling codes for this country
Name
emoji
Type
string
Description
The country's flag as an emoji
Name
ioc
Type
string
Description
The IOCs three-letter representation of the country code (reference)
Name
name
Type
string
Description
The country name data
Name
name_translated
Type
string
Description
The local country name data
Name
timezones
Type
array<string>
Description
All of the available timezones within the country data
Name
is_in_european_union
Type
boolean
Description
true if the country is in the European Union (helpful for GDPR redirects), otherwise `false
Name
fips
Type
string
Description
The FIPS two letter representation of the country code (reference)
Name
geonames_id
Type
integer
Description
reference
Name
hasc_id
Type
string
Description
reference
Name
wikidata_id
Type
string
Description
reference

`country > currencies`

Type: object

Name
symbol
Type
string
Description
The currency symbol
Name
name
Type
string
Description
️ ️The currency name
Name
symbol_native
Type
string
Description
The native currency symbol
Name
decimal_digits
Type
integer
Description
How many decimal digits does the currency use
Name
rounding
Type
integer
Description
The IOCs three-letter representation of the country code (reference)
Name
code
Type
string
Description
️The three letter currency code
Name
name_plural
Type
string
Description
The plural version of the currency

`country > languages`

Type: array<object>

Name
name
Type
string
Description
The language name
Name
name_native
Type
string
Description
The native currency name

`city`

Type: object

Name
fips
Type
string
Description
The FIPS two letter representation of the city code (reference)
Name
alpha2
Type
string
Description
️ The two-letter representation of the city
Name
geonames_id
Type
integer
Description
reference
Name
hasc_id
Type
string
Description
reference
Name
wikidata_id
Type
string
Description
reference
Name
name
Type
string
Description
The region name
Name
name_translated
Type
string
Description
The local region name

{
    "location": {
        "geonames_id": 5368753,
        "latitude": 34.053611755371094,
        "longitude": -118.24549865722656,
        "zip": "90012",
        "continent": {
            "code": "NA",
            "name": "North America",
            "name_translated": "North America",
            "geonames_id": 6255149,
            "wikidata_id": "Q49"
        },
        "country": {
            "alpha2": "US",
            "alpha3": "USA",
            "calling_codes": [
                "+1"
            ],
            "currencies": [
                {
                    "symbol": "$",
                    "name": "US Dollar",
                    "symbol_native": "$",
                    "decimal_digits": 2,
                    "rounding": 0,
                    "code": "USD",
                    "name_plural": "US dollars"
                }
            ],
            "emoji": "🇺🇸",
            "ioc": "USA",
            "languages": [
                {
                    "name": "English",
                    "name_native": "English"
                }
            ],
            "name": "United States",
            "name_translated": "United States",
            "timezones": [
                "America/New_York",
                "America/Detroit",
                "America/Kentucky/Louisville",
                "..."
            ],
            "is_in_european_union": false,
            "fips": "US",
            "geonames_id": 6252001,
            "hasc_id": "US",
            "wikidata_id": "Q30"
        },
        "city": {
            "fips": "0644000",
            "alpha2": null,
            "geonames_id": 5368753,
            "hasc_id": null,
            "wikidata_id": "Q65",
            "name": "Los Angeles",
            "name_translated": "Los Angeles"
        },
        "region": {
            "fips": "US06",
            "alpha2": "US-CA",
            "geonames_id": 5332921,
            "hasc_id": "US.CA",
            "wikidata_id": "Q99",
            "name": "California",
            "name_translated": "California"
        }
    }
}

`timezone` Response Properties

Available in all plans

Name
id
Type
string
Description
The timezone
Name
current_time
Type
string
Description
️The current time as a datetime string
Name
code
Type
string
Description
️ The three-letter code for the timezone
Name
is_daylight_saving
Type
boolean
Description
️ If it is currency in daylight saving
Name
gmt_offset
Type
string
Description
️ The offset to GMT in seconds

{
    "connection": {
        "asn": 13335,
        "organization": "Cloudflare, Inc.",
        "isp": "APNIC Research and Development",
        "range": "1.1.1.1/32"
    }
}

`timezone` Response Properties

>= Medium plan

Name
id
Type
string
Description
The timezone
Name
current_time
Type
string
Description
️The current time as a datetime string
Name
code
Type
string
Description
️ The three-letter code for the timezone
Name
is_daylight_saving
Type
boolean
Description
️ If it is currency in daylight saving
Name
gmt_offset
Type
string
Description
️ The offset to GMT in seconds

{
    "connection": {
        "asn": 13335,
        "organization": "Cloudflare, Inc.",
        "isp": "APNIC Research and Development",
        "range": "1.1.1.1/32"
    }
}

`security` Response Properties

>= Medium plan

Name
is_anonymous
Type
boolean
Description
If the IP is anonymous
Name
is_datacenter
Type
boolean
Description
️ If the IP is an address used in a datacenter
Name
is_vpn
Type
boolean
Description
️ If the IP is a known VPN
Name
is_bot
Type
boolean
Description
️ If the IP is a known bot
Name
is_abuser
Type
boolean
Description
️ If the IP is a known bot
Name
is_known_attacker
Type
boolean
Description
If the IP is a known attacker
Name
is_proxy
Type
boolean
Description
If the IP is a known proxy
Name
is_spam
Type
boolean
Description
If the IP is a known spammer
Name
is_tor
Type
boolean
Description
If the IP is a known Tor endpoint
Name
proxy_type
Type
string
Description
The type of proxy, it can be `vpn or an empty string
Name
is_icloud_relay
Type
boolean
Description
If the IP is a known iCloud relay IP
Name
threat_score
Type
boolean
Description
A threat score on a scale from 0 to 100, with 0 representing no threat and 100 the highest threat level

{
    "security": {
        "is_anonymous": false,
        "is_datacenter": false,
        "is_vpn": false,
        "is_bot": false,
        "is_abuser": false,
        "is_known_attacker": false,
        "is_proxy": false,
        "is_spam": false,
        "is_tor": false,
        "proxy_type": "",
        "is_icloud_relay": false,
        "threat_score": 0
    }
}

`domains` Response Properties

>= Medium plan

Name
count
Type
integer
Description
How many domains are hosted on this domain
Name
domains
Type
array<string>
Description
️️A list of domains hosted on this IP. Up to 5 domains are listed here; more are available with our Hosted Domain API (soon).

You can request all domains via the domains endpoint.

{
    "domains": {
        "count": 12360,
        "domains": [
            "eliwise.academy",
            "accountingprose.academy",
            "pistola.academy",
            "1and1-test-ntlds-fr.accountant",
            "omnergy.africa"
        ]
    }
}

Info Endpoint

IP Information

Optional attributes

Response Structure

Request

Full Response

data Response Properties

range_type Response Properties

connection Response Properties

location Response Properties

Third-party data IDs

country

country > currencies

country > languages

city

timezone Response Properties

timezone Response Properties

security Response Properties

domains Response Properties

`data` Response Properties

`range_type` Response Properties

`connection` Response Properties

`location` Response Properties

`country`

`country > currencies`

`country > languages`

`city`

`timezone` Response Properties

`timezone` Response Properties

`security` Response Properties

`domains` Response Properties