# Eclipse GeoIP REST API

**Canonical:** https://apis.io/apis/eclipse/geoip-api/  
**Provider:** Eclipse Foundation — https://apis.io/providers/eclipse/  
**Base URL:** https://api.eclipse.org/geoip  
**Documentation:** https://webdev.eclipse.org/docs/api/eclipsefdn-geoip-api

Eclipse GeoIP REST API is one of 26 APIs that [Eclipse Foundation](https://apis.io/providers/eclipse/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Foundation, GeoIP, Geolocation, and Infrastructure. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

REST API resolving a client IP address to a country, city or country IP-range set. Used by the Eclipse Foundation to select download mirrors and regionalise content.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/cities/{ipAddr}` | Get city |
| GET | `/countries/{ipAddr}` | Get country |
| GET | `/subnets/{ipv}/{isoCountry}` | Get IP ranges for country code |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/eclipse/refs/heads/main/openapi/eclipse-geoip-api-openapi.yml
- **APIReference** — https://webdev.eclipse.org/docs/api/eclipsefdn-geoip-api
- **Documentation** — https://webdev.eclipse.org/docs/api/eclipsefdn-geoip-api
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/eclipse/refs/heads/main/overlays/eclipse-geoip-api-overlay.yaml

## Other Eclipse Foundation APIs (12)

- [Eclipse Marketplace API](https://apis.io/apis/eclipse/marketplace-api/)
- [Eclipse Foundation Web API](https://apis.io/apis/eclipse/foundation-web-api/)
- [Eclipse Projects API](https://apis.io/apis/eclipse/projects-api/)
- [Open VSX Registry API](https://apis.io/apis/eclipse/open-vsx-api/)
- [Eclipse Newsroom REST API](https://apis.io/apis/eclipse/newsroom-api/)
- [Eclipse Foundation Eclipse Marketplace REST API API](https://apis.io/apis/eclipse/eclipse-eclipse-marketplace-rest-api-api/)
- [Eclipse Foundation Favorites API](https://apis.io/apis/eclipse/eclipse-favorites-api/)
- [Eclipse Foundation Featured API](https://apis.io/apis/eclipse/eclipse-featured-api/)
- [Eclipse Foundation Node API](https://apis.io/apis/eclipse/eclipse-node-api/)
- [Eclipse Foundation Popular API](https://apis.io/apis/eclipse/eclipse-popular-api/)
- [Eclipse Foundation Recent API](https://apis.io/apis/eclipse/eclipse-recent-api/)
- [Eclipse Foundation Search API](https://apis.io/apis/eclipse/eclipse-search-api/)

## Tags

Foundation, GeoIP, Geolocation, Infrastructure

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/eclipse/geoip-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/eclipse/.