API URL
POST /api/v1/ip-geolocation
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
ip
required
string
IPv4 or IPv6 address to check. Must be valid per RFC
include_logs
optional
boolean
Whether to include processing logs in response
Example Request
Code
{
"ip": "8.8.8.8"
}Successful Response
Status
HTML
200 OKBody
Code
{
"ip": "8.8.8.8",
"location": {
"country": "United States",
"region": "California",
"city": "Mountain View",
"latitude": 37.386,
"longitude": -122.0838
},
"network": {
"network": "8.8.8.0/24",
"asn": 15169,
"org": "Google LLC"
}
}Field
Type
Description
ip
string
The IPv4 or IPv6 address that was analyzed for geolocation
found
boolean
location.country | string | Full country name where the IP is registered (e.g., "United States")
location
object
location.region | string | State, province, or administrative region (e.g., "California")
location.country
string
location.city | string | City name derived from geolocation database (e.g., "Mountain View")
location.region
string
location.latitude | number | WGS84 decimal latitude coordinate for geographic positioning
location.city
string
location.longitude | number | WGS84 decimal longitude coordinate for geographic positioning
location.latitude
number
network.network | string | CIDR block notation representing the IP network range (e.g., "8.8.8.0/24")
location.longitude
number
network.asn | string | Autonomous System Number with AS prefix identifying network operator (e.g., "AS15169")
network
object
network.org | string | Organization name that owns or operates the IP address block (e.g., "Google LLC")
network.network
string
summary.total_requested | number | Count of IP addresses submitted in batch request
network.asn
string
summary.found | number | Count of IP addresses successfully geolocated
network.org
string
summary.processing_time_ms | number | Total processing time for the request in milliseconds
summary
object
—
summary.total_requested
integer
—
summary.valid_ips
integer
—
summary.invalid_ips
integer
—
summary.found
integer
—
summary.not_found
integer
—
summary.errors
integer
—
summary.processing_time_ms
integer
—
results
array
—
error
string
—
Error Response
Example
Code
400 INVALID_IP – If IP missing or invalid; 404 NOT_FOUND – IP not in dataset; 415 UNSUPPORTED_CONTENT – Content-Type not application/json; 500 SERVER_ERROR – Internal server errorLast Updated: May 4, 2026