Legacy Plans Management API

This page covers the management API for legacy port-based plans — grandfathered customers with a fixed range of ports rather than the traffic-based gateway. Use these endpoints to whitelist source IPs, set the per-port geo defaults, and pull the assigned port list.

Note

If your plan is on the new traffic-based Residential Proxies model (single gateway p.shifter.io:443), use the Residential Proxies API instead — targeting on the new model is encoded in the username per-request, not stored as a plan default.

Authentication

All endpoints authenticate with an api_token query parameter. Generate a token in the panel under Account → API Tokens.

?api_token=YOUR_API_TOKEN

The {membership} path parameter accepts either the Membership ID shown on the plan page in the panel (for example 68057) or the short code from the plan’s URL (for example Rxqk).

Authorized IPs

Legacy plans authenticate by source IP only — whitelist the IPs your scrapers connect from.

List authorized IPs

GET https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

Example:

curl "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN"

Response:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Update authorized IPs

PUT https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Replaces the list of authorized IPs with the values provided.

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token
ips[]	body	yes	Array of IPv4 addresses to whitelist

Example (form-encoded, with method override):

curl -X POST "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

Geo defaults

Legacy ports have a per-plan geo assignment. Set it once and every port in the plan routes through IPs in the configured countries (or advanced filters).

Get current geo assignment

GET https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

Response:

{
  "geo": ["us", "gb"],
  "advanced_geo": []
}

Update geo assignment

PUT https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token
geo[]	body	yes	Array of ISO-3166-1 alpha-2 country codes
advanced_geo[]	body	no	Array of advanced geo filters (city or ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

List proxies

GET https://shifter.io/api/v1/backconnect/{membership}/proxies

Returns the list of host:port entries for each port in your legacy plan.

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

Response:

{
  "proxies": [
    { "host": "apollo.p.shifter.io", "port": 10001 },
    { "host": "zeus.p.shifter.io", "port": 10002 },
    { "host": "cronos.p.shifter.io", "port": 10003 }
  ]
}

Method overrides

Many proxy-aware HTTP clients strip non-standard methods. The management API accepts POST with a _method=PUT form field as equivalent to PUT.

See also

• Legacy port model
• Authentication — how legacy auth differs from Residential Proxies and ISP Proxies