User risk API
Introduction
The User Risk API is a simplified version of our comprehensive Hazard Report API and is a first line of defense solution for common access control scenarios. The API response provides a low, moderate, or high-risk level for the queried IP address.
A low-risk response means that the address passes all security checks, although there is still some risk.
A moderate risk indicates that the IP address is likely associated with a hosting environment or is a VPN or proxy.
A high-risk level signifies that the address is blocklisted, TOR is detected, or it is bogon or unreachable. The User Risk API can help build a less intrusive CAPTCHA solution for defending less critical resources.
Get started
This API is part of the IP Geolocation package and is available in free and paid plans. Please visit the IP Geolocation package page for limits and pricing information.
Endpoints
IPv4 only API Endpoint
Use this endpoint to force API calls routed over the IPv4 network only
Dual-Stack API Endpoint
This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks
Request
Responses
Example query
https://api-bdc.net/data/user-risk?ip=8.8.8.8&key=[YOUR API KEY]
Example response
Schema
Possible values: Low, Moderate, High
Risk description