API URL
POST /ip-intelligence
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
ip
required
string
IP address for single lookup via GET endpoint (uses client IP if not provided)
Example Request
Code
GET /api/v1/ip-intelligence?ip=8.8.8.8Successful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"data": {
"ip": "8.8.8.8",
"trust_score": 95,
"is_vpn": false,
"is_tor": false,
"asn": "AS15169",
"country": "US",
"org": "Google LLC"
},
"meta": {
"timestamp": "2024-01-15T10:30:00.000Z",
"processing_time_ms": 125
},
"correlationId": "req-123456789"
}Field
Type
success
boolean
data
object
data.ip
string
data.trust_score
integer
data.is_vpn
boolean
data.is_tor
boolean
data.asn
string
data.country
string
data.org
string
data.found
boolean
data.summary
object
data.summary.total_requested
integer
data.summary.valid_ips
integer
data.summary.invalid_ips
integer
data.summary.found
integer
data.summary.not_found
integer
data.summary.errors
integer
data.results
array
meta
object
meta.timestamp
string
meta.processing_time_ms
integer
meta.batch_size_range
string
correlationId
string
error
string
Error Response
Example
Code
{
"error": "Bad Request"
}Last Updated: May 4, 2026