Traffic Statistics

Returns traffic usage aggregated per day, with the estimated cost for each day. Filter by date range and, optionally, by a single proxy access or whitelist IP.

Get Statistics

Endpoint

GET /api/v2/rotating-proxies/stats/

Query Parameters

Parameter	Type	Required	Description
date_from	string	No	Start date YYYY-MM-DD (default: 7 days ago)
date_to	string	No	End date YYYY-MM-DD (default: today)
sub_user_id	string	No	Restrict to one proxy access (UUID)
ip_id	string	No	Restrict to one whitelist IP (UUID)

sub_user_id and ip_id are mutually exclusive.

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v2/rotating-proxies/stats/?date_from=2026-06-18&date_to=2026-06-24' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response

{
  "spent_mb": 1340,
  "timeline": [
    { "date": "2026-06-20", "traffic_mb": 420, "price_usd": 1.23 },
    { "date": "2026-06-21", "traffic_mb": 510, "price_usd": 1.49 },
    { "date": "2026-06-22", "traffic_mb": 410, "price_usd": 1.20 }
  ]
}

Response Fields

Field	Type	Description
spent_mb	integer	Total traffic consumed in the range, in MB
timeline	array	Per-day breakdown
timeline[].date	string	Day in YYYY-MM-DD
timeline[].traffic_mb	integer	Traffic consumed that day, in MB
timeline[].price_usd	number	Estimated cost of that day's traffic in USD

Error Responses

Invalid Parameters (400)

{
  "detail": "date_from must be YYYY-MM-DD."
}

{
  "detail": "user_id and ip_id are mutually exclusive."
}

No Active Subscription (404)

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

Notes

• Days with no traffic are omitted from timeline.
• price_usd is computed from your plan's price per GB and is an estimate for reporting; authoritative billing is reflected in your account balance.