API URL
POST /ip-geolocation
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
ip
required
string
Single IP address for lookup (POST single endpoint)
include_logs
optional
boolean
Log successful lookups to database for compliance tracking
Example Request
Code
{
"ip": "8.8.8.8"
}Successful Response
Status
HTML
200 OKBody
Code
{
"ip": "8.8.8.8",
"found": true,
"location": {
"country": "United States",
"region": "California",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775
},
"network": {
"network": "8.8.8.0/24",
"asn": "AS15169",
"org": "Google LLC"
}
}Field
Type
ip
string
found
boolean
location
object
location.country
string
location.region
string
location.city
string
location.latitude
number
location.longitude
number
network
object
network.network
string
network.asn
string
network.org
string
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
{
"error": "Bad Request"
}Last Updated: May 4, 2026