> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turnoxy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parameters

> Customize proxy requests

Append parameters to the username with `-` delimiter:

```
{username}-{param}-{value}-{param}-{value}:{password}@{host}:{port}
```

## Quick Reference

| Parameter | Values                                                                 | Default | Description                       |
| --------- | ---------------------------------------------------------------------- | ------- | --------------------------------- |
| `country` | [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) | random  | Country code                      |
| `state`   | lowercase + underscore                                                 | -       | State/province (requires country) |
| `city`    | lowercase + underscore                                                 | -       | City name (requires country)      |
| `session` | 4-20 alphanumeric                                                      | -       | Session ID for sticky IP          |
| `ttl`     | 1-60                                                                   | 30      | Session duration (minutes)        |
| `timeout` | 1-120                                                                  | 30      | Connection timeout (seconds)      |

***

## country

[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.

| Code | Country        | Code | Country   |
| ---- | -------------- | ---- | --------- |
| `US` | United States  | `JP` | Japan     |
| `GB` | United Kingdom | `DE` | Germany   |
| `CA` | Canada         | `AU` | Australia |
| `FR` | France         | `SG` | Singapore |

```bash theme={null}
sub_xxx-country-US:pass@gate.turnoxy.com:1318
```

***

## state

State or province. Requires `country`.

Format: lowercase, underscores for spaces (`new_york`, `california`)

```bash theme={null}
sub_xxx-country-US-state-california:pass@gate.turnoxy.com:1318
```

***

## city

City name. Requires `country`.

Format: lowercase, underscores for spaces (`los_angeles`, `new_york`)

```bash theme={null}
sub_xxx-country-US-city-los_angeles:pass@gate.turnoxy.com:1318

# With state for precision
sub_xxx-country-US-state-california-city-los_angeles:pass@gate.turnoxy.com:1318
```

<Note>
  If `city` conflicts with `state`, the system falls back to state-level targeting.
</Note>

***

## session

Keep the same IP across requests.

| Mode           | Parameters        | Behavior                       |
| -------------- | ----------------- | ------------------------------ |
| Rotating       | (none)            | New IP each request            |
| Sticky         | `session`         | Same IP for 30 min             |
| Sticky + TTL   | `session` + `ttl` | Same IP for specified duration |
| Timed Rotation | `ttl` only        | Auto-rotate every N minutes    |

```bash theme={null}
# Sticky session
sub_xxx-session-order123:pass@gate.turnoxy.com:1318

# Sticky with custom TTL
sub_xxx-session-order123-ttl-10:pass@gate.turnoxy.com:1318
```

***

## ttl

Session duration in minutes (1-60). Default: 30.

```bash theme={null}
sub_xxx-session-task01-ttl-15:pass@gate.turnoxy.com:1318
```

***

## timeout

Connection timeout in seconds (1-120). Default: 30.

```bash theme={null}
sub_xxx-timeout-60:pass@gate.turnoxy.com:1318
```

***

## Complete Example

```bash theme={null}
sub_xxx-country-US-state-california-city-los_angeles-session-task01-ttl-15-timeout-60:pass@gate.turnoxy.com:1318
```

See [Errors](/errors) for validation errors.