Exclude State Targeting

Execute a proxy request while excluding specific states from the routing.

How to Specify State Exclusion

To exclude states in your proxy request, append: -not.state-<state_1>,<state_2>
after your <geonode_username>.

You can pass a single exclusion like -not.state-<state>
or add multiple exclusions separated by commas: -not.state-california,newyork,texas

You can only exclude states — not mix with city, country, or ASN exclusions in the same request.

Example curl request

cURL

curl --request GET \
     -x "http://proxy.geonode.io:<port>" \
     --user "<geonode_username>-country-<country_code>-not.state-<state_1>,<state_2>:<geonode_password>" \
     --url "http://ip-api.com/json"

200

{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "NY",
  "regionName": "New York",
  "city": "Queens",
  "zip": "11436",
  "lat": 40.6744,
  "lon": -73.8016,
  "timezone": "America/New_York",
  "isp": "Charter Communications",
  "org": "Spectrum",
  "as": "AS12271 Charter Communications Inc",
  "query": "72.227.174.55"
}

Response

200

application/json

Successful proxy response with excluded states.

status · string

Indicates request status.

Example:

"success"

country · string

Country name.

Example:

"United States"

countryCode · string

Two-letter ISO country code.

Example:

"US"

region · string

Region code.

Example:

"NY"

regionName · string

Full region name.

Example:

"New York"

city · string

City name.

Example:

"Queens"

zip · string

Postal code.

Example:

11436

lat · number

Latitude.

Example:

40.6744

lon · number

Longitude.

Example:

-73.8016

timezone · string

Timezone.

Example:

"America/New_York"

isp · string

Internet Service Provider.

Example:

"Charter Communications"

org · string

Organization.

Example:

"Spectrum"

as · string

Autonomous system name.

Example:

"AS12271 Charter Communications Inc"

query · string

IP address returned.

Example:

"72.227.174.55"