API URL
POST /api/v1/ip-intelligence, POST /api/v1/ip-intelligence
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
ip
required
string
IPv4 or IPv6 address. If not provided, the API attempts to infer the requester IP from headers or socket
Example Request
Code
{
"ip": "203.0.113.45"
}Successful Response
Status
HTML
200 OKBody
Code
{
"ip": "203.0.113.45",
"id": 1,
"network": "203.0.113.0/24",
"description": "Example Block"
}Field
Type
Description
success
boolean
summary.total_requested | number | Count of IP addresses submitted for batch intelligence analysis
data
object
summary.processing_time_ms | number | Total processing time for the intelligence lookup in milliseconds
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
400 INVALID_IP – If IP format is invalid; 404 NOT_FOUND – If no CIDR block matches the IP; 500 INTERNAL_ERROR – On unexpected database or server errorLast Updated: May 4, 2026