API URL
POST /validate
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
ip
required
string
A single IP or CIDR string (if ips not used)
Content-Type
required
string
Must be application/json for POST requests
Example Request
Code
GET /api/v1/validate-ip?api_key=YOUR_API_KEY&ip=192.168.1.1Successful Response
Status
HTML
200 OKBody
Code
{
"ip": "192.168.1.1",
"valid": true,
"type": "IPv4",
"cidr": false,
"private": true,
"reserved": false,
"loopback": false,
"multicast": false,
"link_local": false,
"bogon": false,
"message": "Valid IPv4 address"
}Field
Type
Description
ip
string
Original IP address or CIDR block submitted for network security validation and classification
valid
boolean
RFC compliance status indicating whether the address meets international networking standards
type
string
IP protocol version (IPv4 or IPv6) determining routing and compatibility requirements
cidr
boolean
Network block format detection for subnet management and security policy configuration
private
boolean
Private network classification (RFC 1918) for internal security policy application
reserved
boolean
IANA reserved address space classification for compliance and security filtering
loopback
boolean
Loopback interface identification for network diagnostics and security exception handling
multicast
boolean
Multicast address detection for network traffic management and security assessment
link_local
boolean
—
bogon
boolean
Unallocated or suspicious IP range identification for fraud prevention and threat detection
message
string
Human-readable validation summary for user interface display and logging purposes
error
string
Specific validation failure reason for troubleshooting and input correction guidance
correlationId
string
—
Error Response
Example
Code
400 INVALID_INPUT – If no valid IP or IP list is provided
400 BAD_FORMAT – If IP format is unparseableLast Updated: May 4, 2026