Skip to content
Start free trial

Country targeting

Values are ISO 3166-1 alpha-2 codes: two letters, case insensitive.

Terminal window
curl -x USERNAME:[email protected]:8000 https://checkip.amazonaws.com
Terminal window
curl --proxy-header "X-Rayobyte-Country: DE" \
-x us-east.gw.rayobyte.com:8000 https://checkip.amazonaws.com
CountryValue
United StatesUS
United KingdomGB
GermanyDE
JapanJP
BrazilBR

GB for the United Kingdom, not UK. UK is not an ISO code and matches nothing.

On Premium Residential, the Geolocation picker in the dashboard lists every country, state and city we currently have coverage for. It reads from the live pool, so it is the authoritative answer to “can I get an exit in X”. That answer changes as devices join and leave.

Cuba (CU), Iran (IR), North Korea (KP) and Syria (SY) are not in the picker and cannot be targeted. Asking for one returns 451. See Acceptable use for every blocked location, and for how to ask support to review a block that affects a legitimate business purpose.

Premium Rotating ISP and Premium Rotating DC

Section titled “Premium Rotating ISP and Premium Rotating DC”

Country is the only location option on Premium Rotating ISP and Premium Rotating DC. Send it the same way, on the password or in the header.

Terminal window
curl -x USERNAME:PASSWORD-country-DE@YOUR_HOST:YOUR_PORT https://checkip.amazonaws.com

A country with no exits on the product returns 551 and the request gets no exit. Coverage can change, so read a 551 as “no exit in that country right now”.

Connecting through us-east.gw.rayobyte.com and asking for -country-US gives you a US exit. The entry point only decides where your connection lands first, which affects latency and nothing else.

This confuses almost everybody once. Entry points explains it properly.

On Premium Residential you can add state, city, ZIP and ASN.

Always send the country alongside them. A region name on its own is ambiguous. Several countries have a Georgia, a Victoria and a Santiago.

Was this page helpful?