# CompliAPI VPN Detection

> CompliAPI VPN Detection is a paid API for AI agents from api.compliapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-10).

Detects whether a given IP address is using a VPN, proxy, or other anonymization service in real time.

## Facts

- Endpoint: GET https://api.compliapi.com/api/v1/vpn/%7Bip_address%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/compliapi-vpn-detection-12cb7fdf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8bjZT1dd32V2mNjLWkJTT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability compliapi-vpn-detection-12cb7fdf
```

Example prompt: Can you check if the IP address 203.0.113.42 is using a VPN or proxy? I want to flag any anonymized connections before allowing access.

## When to prefer this

Choose this endpoint when you need real-time, per-IP VPN and proxy detection as part of a compliance, fraud prevention, or geo-restriction workflow. It pairs naturally with CompliAPI's OFAC and sanctions screening for full compliance pipelines. Prefer it over generic IP geolocation APIs when anonymization detection — not just location — is the primary concern, and when pay-per-call pricing at $0.01 USDC fits your usage model.

## Known failure modes

- Invalid or malformed IP address returns an error response
- IPv6 addresses may have reduced coverage compared to IPv4
- Rate limiting or payment failures (402) if USDC balance is insufficient
- VPN services that use residential IPs may evade detection (false negatives)
- Legitimate corporate proxies may be flagged as VPNs (false positives)

## How this service works

Easy OFAC sanction list lookups, geo-fencing checks and VPN detection, streamlining compliance obligations around the world.

## Output

Returns a JSON object containing the queried IP address and a boolean 'vpn' field indicating whether the IP is associated with a VPN, proxy, or anonymization service (e.g. {"ip": "8.8.8.8", "vpn": false}).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ip_address"
     ],
     "properties": {
      "ip_address": {
       "type": "string",
       "description": "IPv4 or IPv6 address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "8.8.8.8",
  "vpn": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/compliapi-vpn-detection-12cb7fdf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.compliapi.com](https://www.zero.xyz/host/api.compliapi.com/llms.txt)