Subscription

Returns your current rotating proxy tariff, remaining traffic balance and the connection data (gateway host and ports) you need to build proxy connections.

Get Subscription

Endpoint

GET /api/v2/rotating-proxies/subscription/

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v2/rotating-proxies/subscription/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response

{
  "expires_at": "2026-07-24T12:00:00Z",
  "traffic_left_mb": 51200,
  "plan_id": "standard-50",
  "plan_label": "Standard 50 GB",
  "proxy_host": "gate.cyberyozh.net",
  "proxy_port": 10000,
  "proxy_port_socks5": 11000,
  "provisioning_status": "active",
  "failure_reason": null,
  "settings": {
    "auto_renewal": false,
    "traffic_renewal_enabled": false,
    "traffic_renewal_threshold_mb": 0
  }
}

Response Fields

Field	Type	Description
expires_at	string|null	Subscription expiry datetime (UTC)
traffic_left_mb	integer	Remaining traffic balance, in megabytes
plan_id	string	Identifier of the current tariff plan
plan_label	string	Human-readable tariff name
proxy_host	string	Proxy gateway hostname
proxy_port	integer	HTTP(S) gateway port
proxy_port_socks5	integer	SOCKS5 gateway port
provisioning_status	string	pending, active, failed or canceled
failure_reason	string|null	Reason when provisioning_status is failed
settings	object	Auto-renewal and traffic auto-top-up settings

Settings Fields

Field	Type	Description
auto_renewal	boolean	Whether the plan renews automatically on expiry
traffic_renewal_enabled	boolean	Whether traffic is auto-topped-up when low
traffic_renewal_threshold_mb	integer	Traffic threshold (MB) that triggers an auto top-up

Error Responses

No Active Subscription (404)

{
  "detail": "No active rotating proxy subscription."
}

Notes

• traffic_left_mb is your traffic balance — usage is metered by the network and deducted as you consume bandwidth.
• Use proxy_host with proxy_port for HTTP(S) connections and with proxy_port_socks5 for SOCKS5.
• Purchasing or changing a plan is done in the dashboard; this endpoint is read-only.