Skip to main content

Proxy Shop

Browse available proxies and place orders.

List Available Proxies

GET /proxies/shop/

Returns a list of proxy products available for purchase.

Query Parameters

ParameterTypeDescription
access_typestringshared or private
countrystringCountry code (ISO 3166-1 alpha-2)
has_vpnbooleanFilter by VPN support
has_xraybooleanFilter by Vless/Xray support
proxy_categorystringdatacenter_dedicated, datacenter_shared, lte, residential_rotating, residential_static
stock_statusstringin_stock or out_of_stock
pageintegerPage number

Response

{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"title": "Best proxy",
"proxy_category": "lte",
"access_type": "private",
"location_country_code": "us",
"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",
"has_xray": true,
"traffic_limitation": -1,
"is_auto_renewal_possible": "true"
}
]
}
]
}

Fields

FieldDescription
proxy_categoryProxy type: lte, residential, datacenter, etc.
stock_statusin_stock or out_of_stock
has_xraySupports Vless/Xray
traffic_limitationTraffic limit in MB; -1 means unlimited
is_auto_renewal_possibleWhether auto-renewal is supported

Buy Proxies

POST /proxies/shop/buy_proxies/

Order one or more proxies by product ID.

Request Body

[
{
"id": "9a440c2a-157f-4562-8209-25022ec41430",
"auto_renew": true,
"promo_code": "PROMO10"
},
{
"id": "9a440c2a-157f-4562-8209-25022ec41430",
"auto_renew": false
}
]

Response

Each item in the response indicates the result of the purchase attempt:

{
"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"
},
{
"id": "9a440c2a-157f-4562-8209-25022ec41430",
"auto_renew": false,
"status": "canceled",
"message": "Not enough money."
}
]
}

Status Values

StatusDescription
in_progressOrder placed successfully, proxy is being provisioned
canceledOrder failed (e.g. insufficient funds)