# 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

```bash
# 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}` |