Endpoints

GET /

Returns a beautiful HTML page displaying your IP information with a dark theme interface.

Response: text/html

Best viewed in a browser. Features:

• Large IP address display with copy-to-clipboard
• Reverse DNS lookup button (client-side, uses Cloudflare DoH)
• Network information cards
• Connection details
• Client information
• Cloudflare headers display (when using Cloudflare Worker)

---

GET /api/v1/info

Returns complete IP information as JSON.

Response: application/json

Request

curl https://ip.cloakprobe.dev/api/v1/info

Response

{
  "ip": "203.0.113.42",
  "ip_version": 4,
  "reverse_dns": null,
  "network": {
    "asn": 64496,
    "as_name": "Example-ISP",
    "prefix": "203.0.113.0/24",
    "rir": "ARIN",
    "country": "US",
    "org_name": "Example Corporation",
    "tor_exit": false,
    "vpn_or_hosting": false
  },
  "connection": {
    "tls_version": "TLSv1.3",
    "http_protocol": "h2",
    "tls_cipher": "AEAD-AES128-GCM-SHA256",
    "cf_ray": "abc123-IAD",
    "datacenter": "IAD"
  },
  "cloudflare": {
    "geo": {
      "country": "US",
      "city": "New York",
      "region": "New York",
      "region_code": "NY",
      "continent": "NA",
      "latitude": "40.7128",
      "longitude": "-74.0060",
      "postal_code": "10001",
      "timezone": "America/New_York"
    },
    "network": {
      "asn": "AS64496",
      "as_organization": "Example-ISP",
      "colo": "IAD"
    },
    "connection": {
      "http_protocol": "h2",
      "tls_version": "TLSv1.3",
      "tls_cipher": "AEAD-AES128-GCM-SHA256",
      "cf_request_id": "abc123def456",
      "cf_cache_status": "MISS"
    },
    "security": {
      "trust_score": "50",
      "bot_score": "1",
      "verified_bot": "false"
    }
  },
  "client": {
    "user_agent": "curl/8.1.2",
    "accept_language": null,
    "accept_encoding": "gzip, deflate",
    "client_hints": {
      "sec_ch_ua": null,
      "sec_ch_ua_platform": null
    }
  },
  "privacy": {
    "mode": "strict",
    "logs_retained": false
  },
  "server": {
    "timestamp_utc": "2024-01-15T10:30:00.123456Z",
    "region": "eu-central",
    "version": "0.1.1"
  }
}

Using with jq

# Get just your IP
curl -s https://ip.cloakprobe.dev/api/v1/info | jq -r '.ip'

# Get ASN info
curl -s https://ip.cloakprobe.dev/api/v1/info | jq '.network'

# Get country code
curl -s https://ip.cloakprobe.dev/api/v1/info | jq -r '.network.country'

---

GET /api/v1/plain

Returns IP information as plain text, ideal for shell scripts.

Response: text/plain

Request

curl https://ip.cloakprobe.dev/api/v1/plain

Response

IP: 203.0.113.42 (IPv4)
ASN: AS64496 Example-ISP (203.0.113.0/24, ARIN, US)
TLS: TLSv1.3 over h2
--- Geo Location ---
Country: US
City: New York
Region: New York
Region-Code: NY
Continent: NA
Latitude: 40.7128
Longitude: -74.0060
Postal-Code: 10001
Timezone: America/New_York
--- Network ---
ASN: AS64496
AS-Organization: Example-ISP
Colo: IAD
--- Connection ---
HTTP-Protocol: h2
TLS-Version: TLSv1.3
TLS-Cipher: AEAD-AES128-GCM-SHA256
--- Security ---
Trust-Score: 50
Bot-Score: 1
Verified-Bot: false
User-Agent: curl/8.1.2

Parsing in Scripts

#!/bin/bash
INFO=$(curl -s https://ip.cloakprobe.dev/api/v1/plain)

# Extract IP
IP=$(echo "$INFO" | grep "^IP:" | cut -d' ' -f2)

# Extract ASN
ASN=$(echo "$INFO" | grep "^ASN:" | cut -d' ' -f2)

echo "Your IP: $IP"
echo "Your ASN: $ASN"

---

GET /healthz

Health check endpoint for monitoring and load balancers.

Response: application/json

Request

curl https://ip.cloakprobe.dev/healthz

Response

{
  "status": "ok"
}

Use this endpoint for:

• Kubernetes liveness/readiness probes
• Load balancer health checks
• Uptime monitoring

Kubernetes Example

livenessProbe:
  httpGet:
    path: /healthz
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /healthz
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 5

---

GET /privacy

Returns the Privacy Policy page in HTML format.

Response: text/html

This page provides comprehensive information about:

• Data collection and processing
• Privacy modes (strict, balanced)
• Cloudflare data processing
• User rights under GDPR and CCPA
• Reverse DNS lookup feature (client-side only)
• Security measures

The privacy policy is accessible from the main page footer and can be viewed at /privacy.

---

Headers Returned

All responses include security headers:

Content-Security-Policy: default-src 'self'; style-src 'self' 'unsafe-inline'; connect-src 'self' https://cloudflare-dns.com
Referrer-Policy: strict-origin-when-cross-origin
X-Frame-Options: DENY
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
Permissions-Policy: accelerometer=(), camera=(), geolocation=(), ...

The connect-src directive includes https://cloudflare-dns.com to allow client-side reverse DNS lookups using Cloudflare DoH.

See Security for details.