1. Get Your IP Address (Plain Text)

Returns your IP address as plain text.

# IPv4
curl http(s)://4.ipvx.cz

# IPv6
curl http(s)://6.ipvx.cz

2. Get Your IP Address (JSON)

Returns your IP address in JSON format.

# IPv4
curl http(s)://4.ipvx.cz?format=json

# IPv6
curl http(s)://6.ipvx.cz?format=json

3. Get Full GeoIP Information

Complete IP data including location, ISP, and reverse DNS.

# Get all info for your IP
curl http(s)://ipvx.cz/json/

# Get info for a specific IP
curl http(s)://ipvx.cz/8.8.8.8/json/

# Pretty print with jq
curl -s http(s)://ipvx.cz/json/ | jq .

4. Get Specific Fields

Extract only the fields you need.

# Get just the country
curl http(s)://ipvx.cz/country/

# Get just the city
curl http(s)://ipvx.cz/city/

# Get timezone
curl http(s)://ipvx.cz/timezone/

# Get reverse DNS
curl http(s)://ipvx.cz/hostname/

5. Query Specific IP Address or Hostname

Look up information for any IP address or hostname (FQDN). Hostnames are resolved to IP automatically.

# Check IPv4
curl http(s)://4.ipvx.cz/1.1.1.1/json/

# Check IPv6
curl http(s)://ipvx.cz/2606:4700:4700::1111/json/

# Lookup by hostname (FQDN) — resolves to IP automatically
curl http(s)://ipvx.cz/example.com/json/

# Get country for specific IP
curl http(s)://ipvx.cz/1.1.1.1/country/

6. Advanced: Script Example

Bash script to display your full IP information.

#!/bin/bash
# Save as ip-info.sh

echo "=== IP Address Information ==="
DATA=$(curl -s http(s)://ipvx.cz/json/)

echo "IP Address: $(echo $DATA | jq -r '.ip')"
echo "Hostname: $(echo $DATA | jq -r '.hostname')"
echo "City: $(echo $DATA | jq -r '.city')"
echo "Region: $(echo $DATA | jq -r '.region')"
echo "Country: $(echo $DATA | jq -r '.country_name')"
echo "Coordinates: $(echo $DATA | jq -r '.latitude'),$(echo $DATA | jq -r '.longitude')"
echo "ISP: $(echo $DATA | jq -r '.org')"
echo "Timezone: $(echo $DATA | jq -r '.timezone')"

7. One-liner Examples

Quick commands for common tasks.

# Show my public IP with country
curl -s http(s)://ipvx.cz/json/ | jq -r '"\(.ip) - \(.country_name)"'

# Check if IP is IPv6
curl -s http(s)://6.ipvx.cz?format=json | jq -r '.ip' | grep -q ':' && echo "IPv6" || echo "IPv4"

# Get reverse DNS for current IP
curl -s http(s)://ipvx.cz/hostname/

# Export to CSV
echo "IP,Country,City,ISP" > ip-info.csv
curl -s http(s)://ipvx.cz/json/ | jq -r '[.ip,.country_name,.city,.org] | @csv' >> ip-info.csv

8. Help & HTTP Support

Get this API reference as plain text in your terminal. Both HTTP and HTTPS are supported.

# Get API help in plain text (curl)
curl http(s)://ipvx.cz/help

9. Rate Limits & Notes

ipvx.cz — 10 requests/sec.

IPvx Network Info

API Reference