Exclude state

Exclude specific states or regions when assigning a proxy IP. This is a username flag on the proxy connection (proxy.geonode.io), not a separate HTTP management API.

Auth

Use your Geonode proxy username and password with the proxy URL.

Username syntax

Form	Example username suffix
Single state	`-not.state-california`
Multiple states	`-not.state-california,newyork,texas`
State exclusion inside a country	`-country-US-not.state-california,newyork`

Full proxy user string shape (with country targeting):

<geonode_username>-country-<COUNTRY>-not.state-<state>[,<state>...]:<geonode_password>

State values are lowercase names without spaces (for example california, newyork).

Rules

Use only one exclusion type per request. Do not combine -not.state- with -not.country-, -not.city-, or -not.asn-.
You can combine positive -country- targeting with -not.state- (include a country, exclude states inside the routing rules you need).

Parameters

Name	In	Required	Description
`geonode_username`	proxy user	yes	Dashboard proxy username (before flags)
`geonode_password`	proxy user	yes	Dashboard proxy password
`country`	username flag	recommended	ISO country code to scope routing (for example `US`)
`not.state`	username flag	yes	Comma-separated state names to exclude
`port`	proxy URL	yes	Proxy port from your plan / dashboard

Example

curl -x "http://proxy.geonode.io:<port>" \
  --proxy-user "<geonode_username>-country-US-not.state-california,texas:<geonode_password>" \
  "http://ip-api.com/json"

Response

The example URL is ip-api.com (IP check). The JSON is that service’s view of the egress IP, not a Geonode API schema.

regionName / region should not match an excluded state when exclusion is applied successfully.

{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "TX",
  "regionName": "Texas",
  "city": "Lubbock",
  "zip": "79423",
  "lat": 33.5134,
  "lon": -101.8818,
  "timezone": "America/Chicago",
  "isp": "Suddenlink Communications",
  "org": "RES",
  "as": "AS19108 Optimum",
  "query": "50.27.41.38"
}

-country-US-not.state-california returned regionName: "Texas" (not California).

Useful fields to check: regionName, countryCode, query.

Guide: Exclude Specific Location
Also in this section: country, city, and ASN exclusion