This guide shows you how to give login:password or IP-based access to your proxies.
Every request uses your personal API key from your account dashboard (how to get your API key). In the examples below, replace YOUR_API_KEY with your own key. To pay from your account balance, use paymentId = 1.
Step 1 — Find the order
List your active proxies and copy the order_number of the order the proxies belong to.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Response
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "order_number": "2000096_20240080", "status_type": "ACTIVE" }
]
},
"errors": []
}
Step 2 — Create the authorization
Create login:password authorization for that order via /auth/add. For IP-based access use /auth/add/ip instead and pass the ip.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/auth/add
Request body
Name | Type | Description |
orderNumber | String | Order number (NOT order_id) — from the proxy list (Step 1). |
generateAuth (optional) | String | Y/N — create custom authorization (default N). |
ip (optional) | String | IP address (for IP-based authorization). |
Example
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/auth/add
Response
{
"status": "success",
"data": {
"id": "66decee1e4b0c423139280d9",
"active": true,
"login": "abcdef1",
"password": "fedcba1",
"orderNumber": "2000096_20240080"
},
"errors": []
}
Step 3 — Confirm the authorization
List the authorizations for your orders to confirm it was created.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/auth/list
Response
{
"status": "success",
"data": [
{ "id": "666059d7f767480029182987", "active": true, "login": "abcdef1", "password": "fedcba1", "orderNumber": "2329050_27159264" },
{ "id": "66dea930354180027393781a", "active": true, "ip": "127.0.0.1", "orderNumber": "2329050_27159263" }
],
"errors": []
}
Full API reference
Retrieve active proxy — list your proxies