Java SDK
The IPWho Java SDK wraps the IP geolocation API in idiomatic Java — typed POJO responses, checked exceptions, and a single Maven dependency. One call returns the full payload: geolocation, timezone, currency, connection (ASN/ISP), security flags, and more.
- Source: lavrox/SDK-IPWho-IP-Geolocation-Java
- Maven:
com.lavrox:ipwho:1.0.0 - API key: ipwho.org/free-plan
Installation
Section titled “Installation”<dependency> <groupId>com.lavrox</groupId> <artifactId>ipwho</artifactId> <version>1.0.0</version></dependency>implementation("com.lavrox:ipwho:1.0.0")Java 11+, OkHttp, Jackson. Package: com.ipwho.
Quick start
Section titled “Quick start”IpWhoClient client = new IpWhoClient(System.getenv("IPWHO_API_KEY"));
IpGeoResponse resp = client.lookup("8.8.8.8"); // GET /ip/{ip}IpGeoResponse me = client.me(); // GET /meList<IpGeoResponse> bulk = client.bulk(Arrays.asList("8.8.8.8", "1.1.1.1"));Error handling
Section titled “Error handling”try { IpGeoResponse resp = client.lookup("8.8.8.8");} catch (InvalidIPException e) { // malformed IP address (404)} catch (RateLimitException e) { // plan limit reached (429)} catch (APIResponseException e) { // unexpected response}Methods
Section titled “Methods”lookup(String ip)—GET /ip/{ip}me()—GET /mebulk(List<String> ips)—GET /bulk/{a,b,c}; returnsList<IpGeoResponse>