API Reference

Returns server-side connection metadata: TLS version negotiated, HTTP protocol, and hostname. Does not log or return the client IP. For public IP detection, use the IP Analysis tool which queries Cloudflare directly from your browser.

Response Fields

# Basic request
curl https://setarys.xyz/api/ip

# Pretty-print with jq
curl -s https://setarys.xyz/api/ip | jq .

const res  = await fetch('https://setarys.xyz/api/ip');
const data = await res.json();

console.log(data.ip);         // "198.51.100.42"
console.log(data.country);    // "CA"
console.log(data.tls);        // "TLSv1.3"

import requests

r    = requests.get('https://setarys.xyz/api/ip')
data = r.json()

print(data['tls'])   # TLSv1.3
print(data['http'])  # h2

Example Response

{
  "tls":    "TLSv1.3",
  "http":   "h2",
  "host":   "setarys.xyz",
  "scheme": "https"
}

Returns the current server timestamp in ISO 8601, Unix epoch (seconds and milliseconds), and UTC offset.

curl https://setarys.xyz/api/time

const { unix, iso } = await fetch('https://setarys.xyz/api/time').then(r => r.json());
console.log(new Date(unix * 1000));

Example Response

{
  "iso":   "2024-11-14T18:42:05.831Z",
  "unix":  1731606125,
  "ms":    1731606125831,
  "utc":   "Thu, 14 Nov 2024 18:42:05 GMT"
}

Returns the full set of HTTP request headers as received by the server. Useful for debugging middleware, CDN configurations, and proxy setups.

Example Response

{
  "headers": {
    "Host":            "setarys.xyz",
    "User-Agent":      "Mozilla/5.0 (X11; Linux x86_64)...",
    "Accept":          "application/json, */*",
    "Accept-Language": "en-CA,en;q=0.9",
    "Accept-Encoding": "gzip, deflate, br"
  }
}

Extended trace including TLS info, HTTP protocol, Cloudflare PoP, and key exchange algorithm.

Example Response

{
  "ip":           "198.51.100.42",
  "tls":          "TLSv1.3",
  "http":         "h2",
  "kex":          "X25519",
  "colo":         "YYZ",
  "loc":          "CA",
  "visit_scheme": "https"
}