Create IP list

Endpoint:

POSThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/residentsubuser/list/add

Path parametrs:

Name	Value	Description
Authorization	`<Your_API_Key>`	Your personal API key

Request body:

Name	Type	Description
title	String	Name of the list you are creating
whitelist	String	IPs for authorization. Leave blank if you want to authorize with login credentials.
geo	object	Add GEO data to your list (country, region, city, ISP)
country	String	Country selected from the GEO database
region	String	Region selected from the GEO database
city	String	City selected from the GEO database
isp	String	ISP selected from the GEO database
export	object	Here you specify the number of IPs in your list and the export type (port numbers and file format)
ports	Number	Number of IPs (maximum 1000)
ext	String	Type of export
rotation	Number	"'-1' for no rotation (Sticky), '0' for rotation per request, '1' to '3600' for time-based rotation in seconds
package_key	String	Key of a subuser's package where you want to add list of IP's

Example:

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/residentsubuser/list/add

Response:

{
    "status": "success",
    "data": {
        "id": 20483779,
        "title": "Andorra Telecom, S.a.u.",
        "login": "b5bb75973e04a569",
        "password": "nMqaohvXmSk1CF2t",
        "whitelist": "",
        "rotation": "-1 = rotation, 0 = rotation per request, 1..60 time in seconds",
        "geo": [
            {
                "country": "AD",
                "region": "Andorra La Vella",
                "city": "Andorra La Vella",
                "isp": "Andorra Telecom, S.a.u."
            }
        ],
        "export": {
            "ports": 1000,
            "ext": "txt"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Tarif not found",
            "code": 0,
            "customData": null
        }
    ]
}

Responses with error in body request:

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Incorrect IP address 0.0.0.0 entered",
            "code": 409,
            "customData": null
        },
        {
            "message": "Incorrect IP address 0.0.0.0 entered",
            "code": 0,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP 127.0.0.1 already linked",
            "code": 0,
            "customData": null
        },
        {
            "message": "IP 127.0.0.1 already linked",
            "code": "0",
            "customData": null
        }
    ]
}

Same error may be in case with wrong "region", "city", "isp"!
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Invalid country (region,  city, isp) ISO code",
            "code": 400,
            "customData": null
        },
        {
            "message": "Invalid country ISO code (400)",
            "code": 0,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "410 GONE \"Invalid ISP name\"",
            "code": 0,
            "customData": null
        }
    ]
}

Endpoint:

Path parametrs:

Request body:

Example:

Response:

Responses with error in body request:

On this page