Check the real-time remaining proxy inventory for a specific product type.
Request
| Header | Value | Required |
|---|
Authorization | Bearer {your_api_key} | Yes |
Path Parameters
The product type identifier (e.g., "captcha", "x1", "level3").
Example Request
curl -X GET "https://dashboard.statproxies.com/api/v2/inventory/fetch/captcha" \
-H "Authorization: Bearer {your_api_key}"
Response
Success Response
{
"product": {
"_id": "64abc123def456789",
"product_id": "captcha",
"product_name": "Captcha Proxies",
"product_category": "datacenter",
"price_id": "price_1234567890",
"datacenter_proxy_port": 3128,
"url_slug": "captcha-proxies"
},
"remaining_inventory": 2500
}
Response Fields
Unique product identifier.
Human-readable product name.
Product category (datacenter, residential).
Stripe price ID for billing.
product.datacenter_proxy_port
Default port for this product’s proxies.
Number of available proxies that can be assigned.
Error Responses
503 Service Unavailable
{
"error": "product_not_found"
}
Available Products
Common product IDs include:
| Product ID | Name |
|---|
captcha | One Click Captcha Proxies |
x1 | X1 Fiber ISP Proxies |
level3 | Level 3 Fiber ISP Proxies |
event | Private Event ISP Proxies |
Contact support for a complete list of available product IDs.
Use Case
This endpoint is useful for:
- Pre-purchase checks: Verify inventory before creating orders
- Capacity planning: Monitor available inventory levels
- Automated systems: Build logic around inventory availability
- Reseller platforms: Display availability to customers
Example Workflow
# 1. Check inventory before ordering
curl -X GET "https://dashboard.statproxies.com/api/v2/inventory/fetch/captcha" \
-H "Authorization: Bearer {your_api_key}"
# Response: {"remaining_inventory": 2500, ...}
# 2. If sufficient inventory, create order
curl -X POST "https://dashboard.statproxies.com/api/v2/order/newscale" \
-H "Authorization: Bearer {your_api_key}" \
-H "Content-Type: application/json" \
-d '{"quantity": 100, "product_type": "captcha"}'
Real-Time Data
The remaining_inventory value reflects:
- Currently unassigned IPs across all servers for that product
- Real-time availability (not cached)
- IPs that are ready for immediate assignment
Inventory can change between checking and ordering. For critical applications, implement retry logic in case an order fails due to insufficient inventory.