Base URL
  https://your-domain.com

Request format
  Content-Type: application/json
  Accept: application/json

Response format
  JSON object on success
  { "error": "Human-readable message" } on failure

# API key (recommended for server-to-server)
Header: X-API-Key: YOUR_API_KEY

Find your key: Dashboard → Settings → API key
Works on: /api/credentials, /api/bandwidth

# Session cookie (browser or server-side login)
1. POST /api/auth/login  { "email", "password" }
2. Store the proxy_session cookie from the response
3. Send it on subsequent requests: Cookie: proxy_session=...

Required for: orders, wallet, ISP, order management

# 1. Load catalog
GET /api/proxy-seller/reference?type=ipv4

# 2. Get a price quote
PUT /api/upstream-orders
{
  "productType": "ipv4",
  "params": { "countryId": 1, "periodId": "1w", "quantity": 10 }
}

# 3. Place order (wallet pays instantly; stripe/crypto return checkoutUrl)
POST /api/upstream-orders
{
  "productType": "ipv4",
  "params": { "countryId": 1, "periodId": "1w", "quantity": 10 },
  "paymentMethod": "wallet",
  "autoRenew": true
}

# 4. If checkoutUrl returned, redirect user then confirm:
POST /api/upstream-orders/confirm
{ "orderId": "...", "sessionId": "..." }

# 5. Fetch credentials
GET /api/upstream-orders
# Each credential → IP:PORT:USERNAME:PASSWORD

# Create a rotating gateway credential
POST /api/credentials
Header: X-API-Key: YOUR_API_KEY
{
  "label": "Scraper pool",
  "sessionMode": "ROTATING",
  "countryFilter": "US,GB"
}

# Response includes username + password
# Connect via your platform gateway:
#   http://USERNAME:PASSWORD@proxy.your-domain.com:8888
#   socks5://USERNAME:PASSWORD@proxy.your-domain.com:1080

# Monitor usage
GET /api/bandwidth?days=30
Header: X-API-Key: YOUR_API_KEY

# Purchased proxies (orders) — connect directly
185.134.194.170:12323:14a449cdc5de4:83b9b00317

curl -x http://USER:PASS@185.134.194.170:12323 https://api.ipify.org
curl --socks5 USER:PASS@185.134.194.170:12323 https://api.ipify.org

# Gateway credentials — connect via platform gateway host
curl -x http://USERNAME:PASSWORD@proxy.your-domain.com:8888 https://api.ipify.org

// Node.js — list credentials with your API key
const API_KEY = process.env.NIDPROXY_API_KEY;
const BASE = "https://your-domain.com";

const res = await fetch(`${BASE}/api/credentials`, {
  headers: { "X-API-Key": API_KEY },
});
const { credentials } = await res.json();

// Node.js — place a wallet order (server-side session)
const login = await fetch(`${BASE}/api/auth/login`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@company.com", password: "..." }),
});
const cookie = login.headers.get("set-cookie"); // store proxy_session

const order = await fetch(`${BASE}/api/upstream-orders`, {
  method: "POST",
  headers: { "Content-Type": "application/json", Cookie: cookie },
  body: JSON.stringify({
    productType: "ipv4",
    params: { countryId: 1, periodId: "1w", quantity: 10 },
    paymentMethod: "wallet",
  }),
});
const data = await order.json();

HTTP status | Meaning
401          | Missing or invalid API key / session
403          | Valid auth but action not allowed
404          | Resource not found
402          | Insufficient wallet balance
429          | Rate limit (e.g. credential reset cooldown)
503          | Feature unavailable (payments or upstream not configured)