/ DEVELOPERS / V1
Your proxies, in your scripts.
Check stock, get a price, buy from your USD balance and download the resulting SOCKS5 connections. The API uses the same balance, prices and inventory as the dashboard.
Start with an API key
Open Settings → API access. Create a read-only key for lists and exports, or enable purchases to let a script spend your balance. Copy the key when it is created; only its hash is stored. Keys expire after 90 days and can be revoked at any time.
Send the key in X-API-Key or Authorization: Bearer. Keep it on your server, out of URLs and public source code. The limit is 120 authenticated requests per minute per key; a 429 response includes Retry-After.
Use X-API-Key for scripts. The API uses HTTPS and the same balance as your dashboard. Check sales_enabled in the catalog before placing an order.
1. Check your balance and available stock
curl -H "X-API-Key: $ISOCKS_API_KEY" \
https://isocks.net/api/auth/meGET /api/auth/me returns your USD balance. GET /api/catalog lists proxy types, country stock, supported durations and whether sales are enabled. Stock can change before an order is placed.
2. Get the exact price
curl 'https://isocks.net/api/quote?quantity=10&network_type=DC&duration_days=7'The quote returns unit_price_usd and total_usd as decimal strings. Choose DC or Residential, 1–100 IPs and a duration of 1, 7, 14, 21 or 30 days. Omit country from an order to use any available country.
3. Buy from your balance
curl -X POST https://isocks.net/api/me/orders \
-H "X-API-Key: $ISOCKS_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"quantity":10,"network_type":"DC","country":"NL",
"duration_days":7,
"request_key":"d7810aec-c18e-4b8d-bdb2-c3e4d1be1b51"}'Generate a new UUID request_key for each intended order. If a response is lost, retry the exact same body with the same key. You receive the existing order and are charged once. A different quantity, country, type or duration requires a new key. The UUID above is an example; do not reuse it for new orders.
A 202 response means provisioning has started. It does not mean the credentials are ready. The full price is debited atomically when stock is reserved; insufficient balance returns 402, and insufficient stock returns 409.
4. Wait for activation, then export
curl -H "X-API-Key: $ISOCKS_API_KEY" \
"https://isocks.net/api/me/orders/$ORDER_ID"Poll the order every five seconds, then read GET /api/me/proxies. Use GET /api/me/proxies/{id}/credentials for one active proxy, or export all active, unexpired connections below. Provisioning failures return the cost of the unissued IP to your balance.
curl -H "X-API-Key: $ISOCKS_API_KEY" \
'https://isocks.net/api/me/export?format=ipport'format=ipport returns host:port:username:password. The default format=userpass returns username:password@host:port. Your account uses one permanent SOCKS5 username and password, also available at GET /api/me/proxy-credentials. The proxy list includes replacement_of, offline_since, status and expires_at; credentials are returned only by the credentials and export endpoints.
Automatic replacement
When fresh controller data shows a proxy offline for five continuous minutes, we look for another IP of the same type and country. Replacement costs nothing and keeps the original expiry. The old access is retired after the new access is confirmed. Your SOCKS5 login stays the same. The IP and port may change, so refresh your export when replacement_of appears.
Replacement depends on available stock, with up to three attempts per rental slot in 24 hours. A controller outage pauses replacements. Website blocks and target-specific errors do not trigger replacement; an ambiguous provisioning response is held for review rather than retried blindly.
Endpoints and errors
| Request | Result |
|---|---|
GET /api/catalog | Stock and rental terms |
GET /api/quote | Exact order price |
GET /api/auth/me | Account balance |
POST /api/me/orders | Buy from balance |
GET /api/me/orders/{id} | Order and proxy status |
GET /api/me/proxies | Your proxy list |
GET /api/me/export | Active connections |
GET /api/me/transactions | Balance history |
GET /api/me/traffic | Your traffic totals |
401: invalid or expired key. 403: the key lacks purchase permission. 404: resource not found in your account. 409: stock or request conflict. 422: invalid fields. 429: rate limit. 503: sales closed or service temporarily unavailable. All authenticated responses use Cache-Control: no-store.