Username Parameter Syntax
In credential mode, all geo-targeting and session control is done by appending parameters to the username — the password never changes. This page is the complete syntax reference.
Structure
{account}-pool-flow[-region-{country code}][-state-{state}][-city-{city}][-asn-{ASN}][-sid-{8-char random}-ttl-{minutes}]
Left to right: account body → pool identifier (always -pool-flow) → geo-targeting parameters → session parameters. The order is fixed and cannot be rearranged.
Parameters
| Parameter | Format | Description |
|---|---|---|
-pool-flow | Fixed value | Residential pool identifier, required in credential mode |
-region-{CC} | ISO two-letter country code | Country targeting, e.g. US, GB, JP, AE; free in all cases |
-state-{State} | State/province name | Must be used together with region, e.g. California |
-city-{city} | City name, lowercase, no spaces | Must be used together with state, e.g. losangeles, newyork |
-asn-{ASN} | AS + digits | ASN (carrier network) targeting, e.g. AS15802; mutually exclusive with state/city, combine with region only |
-sid-{seed} | 8 random alphanumeric characters | Sticky session ID; the same sid reuses the same IP, a new sid gets a new IP |
-ttl-{n} | Integer, 1–120 | Sticky session hold time in minutes; always paired with sid |
Combination rules
- Rotation only, no targeting:
USERNAME-pool-flow - Targeting refines step by step: region → region+state → region+state+city
- ASN targeting cannot be combined with state/city
- Sticky session parameters always come last
- Without
sid/ttl, the default applies: a new IP on every request
Full examples
# 1. Global random IP, rotating per request
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow:PASSWORD" https://ipinfo.io
# 2. Specific country (US)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io
# 3. Down to state level (California, US)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California:PASSWORD" https://ipinfo.io
# 4. Down to city level (Los Angeles, California, US)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD" https://ipinfo.io
# 5. ASN targeting (UAE, AS15802)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD" https://ipinfo.io
# 6. Country + sticky session (same US IP held for 30 minutes)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io
# 7. City-level targeting + sticky session
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io
Not sure how to compose the parameters? The dashboard's Proxy Settings page has a visual builder: pick a country/state/city/session type and it generates the complete username in real time — just copy it. The supported country and city lists are also searchable there.
Common errors
| Symptom | Cause | Fix |
|---|---|---|
| Authentication failed (407) | Username typo or missing -pool-flow | Verify with the dashboard builder |
| City targeting not applied | city used without state | Add -state-{state} |
| ASN targeting not applied | Mixed with state/city | ASN combines with region only |
| IP keeps changing | No sticky session in use | Append -sid-{8 chars}-ttl-{minutes} |