v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-2972102177.5 KB

Browser Sessions

List Sessions History Page

Retrieves a paginated list of sessions for the authenticated team with support for sorting and advanced filtering. This endpoint mirrors the backend session history-page filtering behavior.

get/v1/sessions

Query parameters

pageinteger

Page number to fetch.

limit10 | 20 | 50

Number of sessions per page. Supported values are 10, 20, and 50.

sort_bystring

Sort field. Common values are created_at, session_id, used_credits, and api_key_name.

sort_order'asc' | 'desc'

Sort direction.

searchstring

Comma-separated tag search terms (partial, case-insensitive).

statusstring

Exact session status filter.

tagsstring

Comma-separated tag list. Session must include all provided tags.

domainsstring

Comma-separated domain list. Session must include all provided domains.

created_fromstring date-time

Include sessions created at or after this timestamp (ISO 8601).

created_tostring date-time

Include sessions created at or before this timestamp (ISO 8601).

batch_idstring

Filter by batch identifier.

task_initiatedboolean

Filter by whether the session was task-initiated.

playgroundboolean

Filter by whether the session is a playground session.

proxyboolean

Filter by whether proxy was active for the session.

extra_stealthboolean

Filter by whether extra stealth mode was active.

profile_namestring

Case-insensitive partial match on browser profile name.

Response

Paginated sessions history retrieved successfully.