ProxyWing LogoProxyWing
Browse endpoints

ProxyWing Developer API

Products & Orders

Browse the flat-priced datacenter & ISP catalog and place orders from your balance.

GET/products

List flat-priced products

Returns the catalog of flat-priced products — datacenter and ISP proxies across every location — orderable via POST /orders. price_monthly is the monthly rate; longer billing cycles (quarterly/semiannually/annually) are ordered by passing billing_cycle and are billed at the product's discounted per-cycle price. Residential traffic (priced per GB) and mobile proxies (priced per duration) have their own catalogs: see GET /residential/products and GET /mobile/products.

Auth · Bearer

Query parameters

  • categorystringoptional

    Filter by product family, currently "datacenter" or "isp". Omit to list everything; an unrecognised value simply returns an empty list.

RequestGET /products
curl -X GET "https://api.proxywing.com/v1/products" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
Response200 · application/json
{
  "products": [
    {
      "product_id": "prod_389",
      "category": "isp",
      "group": "ISP US New York Premium",
      "name": "1 Proxy ISP US",
      "price_monthly": 3
    },
    {
      "product_id": "prod_3",
      "category": "datacenter",
      "group": "Proxy UK",
      "name": "1 Proxy DC UK",
      "price_monthly": 1.8
    }
  ]
}
POST/orders

Order a product

Purchases any datacenter or ISP product from GET /products using the account balance. An invoice is created and, if the balance covers it, paid automatically — the service then provisions immediately. If the balance is insufficient the order stays in awaiting_payment and can be settled from the dashboard. Choose a billing_cycle of monthly, quarterly, semiannually or annually — longer terms are billed at the product's discounted per-cycle price (the same rates as the web checkout), and the total field reports exactly what was charged. Residential and mobile use their own order endpoints (POST /residential/orders, POST /mobile/orders) because their pricing differs. Supply an Idempotency-Key header so retries of a timed-out request never double-charge the account.

Auth · BearerIdempotency-Key

Body parameters

  • product_idstringrequired

    The product to order, from GET /products.

  • billing_cyclestringoptional

    Billing term: "monthly" (default), "quarterly", "semiannually" or "annually". Longer terms bill the product's discounted per-cycle price. (Month counts 1/3/6/12 are accepted as aliases.)

  • promo_codestringoptional

    Optional promo code. Only percentage-discount promo codes under 100% off apply via the API (a code that would zero the total is rejected).

RequestPOST /orders
curl -X POST "https://api.proxywing.com/v1/orders" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Idempotency-Key: b3f2a1c4-7e9d-4a2b-8c6f-1d5e9a0b3c7f" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"prod_389","billing_cycle":"quarterly"}'
Response200 · application/json
{
  "order_id": "ord_100002",
  "invoice_id": "inv_200003",
  "product_id": "prod_389",
  "category": "isp",
  "billing_cycle": "quarterly",
  "total": 8.55,
  "status": "paid"
}