How to use

    The WAYSCloud IP Lookup service offers fast and reliable endpoints for checking your public IP address, geolocation, and network info. It is free, lightweight, and built for developers and scripts.

    What does it do?

    • Shows your public IP in plain text or JSON
    • Provides geolocation details like country, ASN, timezone
    • Offers reverse DNS (PTR) lookups
    • Lets you check any IP (e.g. from logs or firewall hits)

    Service URL

    https://ip.wayscloud.services

    Available Endpoints

    Endpoint Description Format
    / or /ip Your public IP in plain text 1.2.3.4
    /json Your public IP in JSON {"ip": "1.2.3.4"}
    /headers Headers sent by your client JSON object
    /user-agent Your User-Agent string Plain text
    /reverse PTR (reverse DNS) lookup for your IP Hostname or fallback
    /country Country of your IP Plain text
    /geo Full geolocation info JSON object
    /geo/{ip} Geolocation for any IP JSON object
    /reverse/{ip} PTR lookup for any IP Hostname or fallback
    /country/{ip} Country for any IP Plain text
    /help This help overview Plain text

    Example: Your IP

    curl https://ip.wayscloud.services/
# 203.0.113.45

curl https://ip.wayscloud.services/json
# {"ip": "203.0.113.45"}

curl https://ip.wayscloud.services/geo
# {
#   "ip": "203.0.113.45",
#   "country": "Norway",
#   "asn": "WAYSCloud AS",
#   "asn_number": 12345,
#   "timezone": "Europe/Oslo"
# }

    Example: External IP Lookup

    curl https://ip.wayscloud.services/geo/8.8.8.8
curl https://ip.wayscloud.services/country/1.1.1.1
curl https://ip.wayscloud.services/reverse/8.8.8.8

    This makes it easy to enrich your logs, dashboards, or alerts with external IP info.

    Good to Know

    • All endpoints support both HTTP and HTTPS
    • Requests from curl/wget/etc. are allowed over HTTP (no redirect)
    • Browsers are redirected to HTTPS automatically
    • Responses are minimal and suitable for scripting or parsing (e.g. with jq)

    Best Practices

    • Use curl -s or curl -L to suppress progress/follow redirects
    • Respect the burst-friendly rate limit
    • Use /geo or /geo/{ip} for complete lookup data
    • Avoid calling unsupported or deprecated endpoints

    License

    WAYSCloud proudly offers this as a free and open service.
    Feel free to integrate it into devtools, CI pipelines, monitoring dashboards or CLI scripts.

    Published