# Session control

Session behavior depends on the proxy product.

| Product     | Rotating             | Sticky/static | Notes                                                                    |
| ----------- | -------------------- | ------------- | ------------------------------------------------------------------------ |
| Residential | Yes                  | Yes           | Sticky sessions can keep one residential route for a multi-step workflow |
| Mobile      | Yes                  | Yes           | Sticky sessions preserve continuity on a carrier route                   |
| ISP         | No rotation required | Static        | The assigned dedicated IP stays fixed for the package term               |

## Rotating sessions

Choose `rotating` when independent requests should use fresh routes. This is the
default for residential and mobile proxy generation.

Typical uses include broad web data collection, price monitoring, and search
result monitoring.

## Sticky sessions

Choose `sticky` when several requests must keep the same route, such as a login,
cart, test flow, or other stateful sequence. Set a positive duration and use one
of these units:

- `min`
- `hour`
- `day`

Residential product pages advertise sticky sessions up to 24 hours. The public
API contract accepts a positive duration, but clients should not assume that a
residential route will remain unchanged beyond the advertised 24-hour window.

## Public API fields

The residential and mobile generation endpoints accept:

| Field          | Values               | Default    |
| -------------- | -------------------- | ---------- |
| `sessionType`  | `rotating`, `sticky` | `rotating` |
| `duration`     | Positive integer     | `60`       |
| `durationUnit` | `min`, `hour`, `day` | `min`      |
| `protocol`     | `http`, `socks5`     | `http`     |
| `count`        | 1–10,000             | `1`        |

The public API returns the gateway, port, username, password, and formatted
connection string for every generated proxy.

See the request and response schemas in the
[Vital Data API reference](https://docs.vital-data.io/).

Related: [targeting](https://www.vital-data.io/docs/targeting.md) ·
[products](https://www.vital-data.io/products.md)

Last reviewed: 2026-07-24.