This page will help you get started with IP Proxy API
The IP Proxy endpoint determines whether a given IP address exhibits characteristics associated with anonymization or masking services, such as VPNs, proxies, relays, or Tor nodes. It returns a series of boolean flags and a proxy type when applicable, allowing customers to quickly identify potentially risky traffic during onboarding, login, or session evaluation workflows.
A key strength of this endpoint is its ability to detect residential proxy traffic, a technique increasingly used in fraud operations. Residential IPs originate from legitimate consumer ISP ranges, making them harder to identify as risky. By classifying proxy sources as either datacenter or residential, the endpoint helps uncover hidden fraud patterns and improves the accuracy of risk assessment.
Request
Following an example of a IP Proxy
curl --request POST \
--url https://api.trustfull.com/data/1.0/ip-proxy \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-api-key: [your_app_key]' \
--data '
{
"transaction_id": "00001",
"ip": "192.168.9.10"
}'Here's a detailed explanation of all fields needed for the api call:
name | type |
|---|---|
transaction_id | string A unique identifier for the transaction. Duplicate values are not allowed. Ex: 4115d9d9-28f4-4100-8701-cafe2adbc4c2 |
ip | string The IP address to be inspected. Ex: 192.168.9.10 |
Response
Following is an example of the response:
{
"is_valid_format": true,
"is_vpn": true,
"is_relay": false,
"is_proxy": true,
"is_tor": false,
"proxy_type": "residential"
}
Here's a detailed explanation of all fields returned:
name | type |
|---|---|
is_valid_format | boolean Indicates whether the IP address is structurally valid. Ex: true |
is_vpn | ?boolean True if the IP is associated with a VPN service. Ex: true |
is_relay | ?boolean True if the IP is identified as a relay or forwarding node. Ex: true |
is_proxy | ?boolean True if proxy usage has been detected. Ex: true |
is_tor | ?boolean True if the IP is a known Tor node. Ex: true |
proxy_type | ?string The detected proxy type when available. Ex: residential, datacenter |
FAQ
Following are some common questions for this specific API:
Why do need to pass a transaction_id?This value is useful to refer to a specific transaction in the system. Using only the IP address can lead to collision in case of duplicated call for the same IP address. Transaction id must be unique across all Trustfull api endpoints.
What happen if i pass an invalid IP address?If the IP provided has an invalid format, the response will only include the is_valid_format field (false)—charged at the same rate as a standard API call.