Eclipse GeoIP REST API (1.0.0)

Download OpenAPI specification:Download

REST client to retrieve GeoIP information about IP addresses and to lookup IP information for countries given their ISO country code.

Get city

path Parameters
ipAddr
required
string

a valid IP address to retrieve the city of origin for.

Responses

Response samples

Content type
application/json
{
  • "geoname_id": 0,
  • "names": {
    }
}

Get country

path Parameters
ipAddr
required
string

a valid IP address to retrieve the country of origin for.

Responses

Response samples

Content type
application/json
{
  • "geoname_id": 0,
  • "iso_code": "string",
  • "names": {
    },
  • "is_in_european_union": true
}

Get IP ranges for country code

path Parameters
ipv
required
string
Enum: "ipv4" "ipv6"

Which list of subnets to retrieve IP ranges for.

isoCountry
required
string = 2 characters

The 2 letter ISO code for the country to retrieve (case-insensitive).

Responses

Response samples

Content type
application/json
[
  • "192.168.1.0/24"
]