# Info Endpoint

Checks the provided ip address (both v4 & v6 formats) and returns all available information. If you omit the ip parameter, the API looks up the IP address the request was made from.

Request Method: GET
Request URL: https://api.freeiplookupapi.com/v1/info

# Request Parameters

Parameter Type Mandatory Description
apikey string Your API Key
ip string The IPv4 or IPv6 address you want to look up as a query parameter. Defaults to the caller's IP.

# Example Request

https://api.freeiplookupapi.com/v1/info?apikey=xxxxxxxxxxxxx&ip=1.1.1.1

# Sample Response

{
    "ip": "1.1.1.1",
    "country_code": "AU",
    "country_name": "Australia",
    "region_code": "AU-NSW",
    "region_name": "New South Wales",
    "city": "Sydney",
    "postal_code": "2000",
    "time_zone": "Australia/Sydney",
    "latitude": -33.86,
    "longitude": 151.2
}

Unknown IPs

If we have no geolocation data for an IP, the API still returns 200 with the same response shape: all string fields are empty and latitude/longitude are 0. Check for an empty country_code rather than relying on the coordinates — 0,0 is a valid location.

Sandbox API keys

Requests made with a sandbox API key always return the data for 1.1.1.1, regardless of the ip parameter, and do not count against your quota (X-Cost: 0).