Get IP Lists

GET https://proxy-sale.com/personal/api/v1/{apiKey}/resident/lists

This endpoint provides a list of your existing IP lists in a package, making it easy to see all your residential proxy setups.

To download your specific list of residential proxies, use the endpoint: https://proxy-sale.com/personal/api/v1/{apiKey}/proxy/download/resident?listId=123. Replace {apiKey} with your API key and 123 with your list ID for direct download of the proxy list.

Headers

Name	Value
Accept	application/json

Path parameters

Name	Type	Description
apiKey*	string	API key to authorize requests

Request examples

cURL

curl -X 'GET' \
  'https://proxy-sale.com/personal/api/v1/YOUR_API_KEY/resident/lists' \
  -H 'accept: application/json'

PHP

<?php
$apiKey = 'YOUR_API_KEY';
$url = "https://proxy-sale.com/personal/api/v1/$apiKey/resident/lists";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Java

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class GetIPListsExample {
    public static void main(String[] args) {
        String apiKey = "YOUR_API_KEY";
        try {
            URL url = new URL("https://proxy-sale.com/personal/api/v1/" + apiKey + "/resident/lists");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");
            conn.setRequestProperty("Accept", "application/json");

            BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String inputLine;
            StringBuilder response = new StringBuilder();

            while ((inputLine = in.readLine()) != null) {
                response.append(inputLine);
            }
            in.close();

            System.out.println(response.toString());

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Response examples

200 (success)

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": 3350393,
        "title": "US Washington Garfield FIRST-STEP",
        "login": "3c8aa1d4",
        "password": "AZT62Dx3",
        "whitelist": "127.0.0.1,192.168.0.1",
        "rotation": "-1 = rotation, 0 = rotation per request, 1..60 time in seconds",
        "geo": [
          {
            "country": "US",
            "region": "Washington",
            "city": "Garfield",
            "isp": "FIRST-STEP"
          }
        ],
        "export": {
          "ports": 1000,
          "ext": "txt"
        }
      }
    ]
  },
  "errors": []
}