Proxy Shop

Browse and purchase available proxies.

Browse Available Proxies

Get a paginated list of proxies available for order with optional filters.

Endpoint

GET /proxies/shop/

Query Parameters

Parameter	Type	Required	Description
access_type	string	No	Proxy access type. Values: shared, private
country	string	No	Filter by country code (ISO 3166-1 alpha-2, e.g., us, au)
proxy_category	string	No	Filter by category. Values: datacenter, lte, residential_rotating, residential_static
stock_status	string	No	Filter by availability. Values: in_stock, out_of_stock
page	integer	No	Page number for pagination
page_size	integer	No	Number of results per page

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/shop/?country=us&proxy_category=lte' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "proxy_products": [
        {
          "id": "9a440c2a-157f-4562-8209-25022ec41430",
          "title": "Best proxy 1",
          "location_country_code": "us",
          "price_usd": "2.00",
          "days": 1,
          "proxy_category": "lte",
          "stock_status": "in_stock",
          "traffic_limitation": -1,
          "is_auto_renewal_possible": true
        }
      ],
      "title": "Best proxy",
      "proxy_category": "lte",
      "access_type": "private",
      "location_country_code": "us"
    }
  ]
}

Response Fields

Field	Type	Description
count	integer	Total number of results
next	string	URL of the next page (null if last)
previous	string	URL of the previous page (null if first)
results	array	Array of proxy product groups
results[].title	string	Group title
results[].proxy_category	string	Category: datacenter, lte, residential_rotating, residential_static
results[].access_type	string	Access type: shared or private
results[].location_country_code	string	Country code
results[].proxy_products	array	Products in this group
proxy_products[].id	string (UUID)	Product identifier
proxy_products[].title	string	Product name
proxy_products[].location_country_code	string	Country code
proxy_products[].price_usd	string	Price in USD
proxy_products[].days	integer	Duration in days
proxy_products[].proxy_category	string	Category
proxy_products[].stock_status	string	Availability: in_stock or out_of_stock
proxy_products[].traffic_limitation	integer	Traffic limit in bytes (-1 for unlimited)
proxy_products[].is_auto_renewal_possible	boolean	Whether auto-renewal is available

Purchase Proxies

Order one or more proxies.

Endpoint

POST /proxies/shop/buy_proxies/

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number for pagination
page_size	integer	No	Number of results per page

Request

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/proxies/shop/buy_proxies/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "id": "9a440c2a-157f-4562-8209-25022ec41430",
      "auto_renew": true
    },
    {
      "id": "24f80c50-5eb3-40fd-a785-eaf9456a045d",
      "auto_renew": false,
      "promo_code": "promo_code_valid"
    }
  ]'

Request Fields

Field	Type	Required	Description
id	string (UUID)	Yes	Product ID from shop listing
auto_renew	boolean	Yes	Enable auto-renewal
promo_code	string	No	Optional promo code

Response

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9a440c2a-157f-4562-8209-25022ec41430",
      "auto_renew": true,
      "status": "in_progress",
      "message": "9a440c2a-157f-4562-8209-25022ec4143a",
      "promo_code": null
    },
    {
      "id": "24f80c50-5eb3-40fd-a785-eaf9456a045d",
      "auto_renew": false,
      "status": "canceled",
      "message": "Promo code is not applicable anymore. Please re-enter it.",
      "promo_code": "promo_code_valid"
    }
  ]
}

Response Statuses

Status	Description
in_progress	Order is being processed
canceled	Order failed (see message for details)

Common Error Messages

• "Not enough money." - Insufficient balance
• "Promo code is not applicable anymore. Please re-enter it." - Invalid or expired promo code