Protocols

The right protocol depends on your use case. The cURL examples below help you verify that your proxy is working correctly before integrating it into your application.

The placeholders username:password@host:port in all examples must be replaced with your actual proxy credentials. Testing with the placeholders will fail.

---

HTTP

Suitable for most everyday use cases where encryption between client and proxy is not required.

curl -x http://username:password@host:port https://ipinfo.io

HTTPS

Use when you need encryption between your client and the proxy server.

curl -x https://username:password@host:port https://ipinfo.io

SOCKS5

A general-purpose proxy protocol for non‑HTTP applications like chat apps or game clients.

curl -x socks5h://username:password@host:port https://ipinfo.io

The h in socks5h forces hostname resolution on the proxy server side, which enhances privacy.

---

Verifying Proxy

When the above command is executed successfully, ipinfo.io returns the IP address of the request source, along with additional information.

Output Example:

{
  "ip": "173.44.168.103",
  "city": "Houston",
  "region": "Texas",
  "country": "US",
  "loc": "29.7633,-95.3633",
  "org": "AS174 Cogent Communications, LLC",
  "postal": "77002",
  "timezone": "America/Chicago",
  "readme": "https://ipinfo.io/missingauth"
}