Developer guide

ProxyIndustry API

Browse products, place wallet-funded orders, and track fulfillment from your own application using the same catalog and fulfillment flow as the website.

Base URL: https://proxyindustry.com/api/v1
Authenticate with Authorization: Bearer pi_live_.... Create tokens in Dashboard > Developers. Your account must be verified and have enough wallet balance.

1. Create an API token

Dashboard > Developers > Create token. Copy the secret when it is shown; it cannot be viewed again.

Create separate tokens for different integrations. Revoke a token at any time from Dashboard > Developers.

2. Browse products

curl 'https://proxyindustry.com/api/v1/catalog/products?page=1&pageSize=20' \
  -H 'Authorization: Bearer pi_live_YOUR_TOKEN'

The catalog response includes product IDs, availability, package sizes, and current prices. The server determines the purchase price.

3. Purchase a product

curl -X POST https://proxyindustry.com/api/v1/orders \
  -H 'Authorization: Bearer pi_live_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: checkout-2026-001' \
  -d '{"productId":"PRODUCT_UUID","quantity":1,"customerReference":"your-order-1042"}'

Purchases are charged to your wallet. Quantity is the number of product packages. Customer reference is optional, account-unique, and useful for tracking. Reuse the Idempotency-Key only for retries of the same request.

4. Track fulfillment

curl 'https://proxyindustry.com/api/v1/orders/by-reference?reference=your-order-1042' \
  -H 'Authorization: Bearer pi_live_YOUR_TOKEN'

The response includes the order ID and status: pending, processing, completed, failed, or refunded. You can also list orders with GET /orders.

Marketplace purchases

List categories with GET /marketplace/categories and products with GET /marketplace/categories/{id}. Purchase via POST /marketplace/purchase with { itemKey, quantity, countryId?, ipv4Type?, customerReference? } and an Idempotency-Key header. Purchases are charged to your wallet.

Useful endpoints

  • GET /orders - list orders
  • GET /orders/{id} - get order details
  • GET /wallet - check balance
  • POST /key-orders - buy a configured proxy package
  • GET /catalog/quote - quote before purchase

Requests are rate-limited per account and IP. Keep tokens on your server, never in browser code or public repositories, and revoke a token if it may have been exposed. Admins can revoke all tokens from the admin dashboard.