API reference
Manage your ProxyGuys proxies from code: list them, read connection details, rotate the IP, change location, renew, and buy.
Base URL
https://proxyguys.com/api/v1
Authentication
Authorization: Bearer pt_live_...
Create a key on the API page of your dashboard (sign-in required). One-hit GET rotate URLs can pass ?key= instead.
Machine-readable catalog
GET https://proxyguys.com/api/v1
No key needed. Returns every endpoint, the proxy object and usage notes as JSON, for scripts and AI agents.
Retries
Send Idempotency-Key: <a stable value> on POST /purchase and POST /proxies/{id}/renew: the same key never charges twice, so retrying is safe.
Code examples
GET/proxies
Every proxy on your account, with state, location and connection info.curl -X GET "https://proxyguys.com/api/v1/proxies" \ -H "Authorization: Bearer pt_live_..."
Questions: support@proxyguys.com