Developers
XProxy API Reference
Code-verified reference for the XProxy Box API and Hub API: parameters, responses, errors with remedies, safety levels for AI agents, and ready-to-run samples.
- 151Box operations
- 20sections
- 4safety levels for AI agents
- .mdtwin of every page
Start with these
GETGet a new public IP for one proxy/api/v1/rotate_ip/proxy/{proxy}GETList connected proxies with ports, public IPs and modem details/api/v1/info_listGETShow a customer the data used, quota left and next reset time of the proxy they rent/selling/quota_info_by_tokenPOSTChange the IMEI of one or more modems/v2/imei_change_in_bulk
Safety levels
- Read onlyChanges nothing. An agent can call it freely.
- ActionDoes something on the box, such as rotating an IP. Ask first.
- DestructiveCan lose data or interrupt customers. Needs explicit approval.
- SecretReturns or accepts credentials. Never log or share the values.
APIs
Box API
HTTP API of the XProxy box controller (the panel on your box).
Hub API
HTTP API of XProxy Hub, the service that manages many boxes in one place.