---
title: "List Sessions History Page"
method: GET
path: "/v1/sessions"
tags: ["Browser Sessions"]
---

# List Sessions History Page

`GET /v1/sessions`

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.

## Query parameters

- `page` integer
- `limit` 10 | 20 | 50
- `sort_by` string
- `sort_order` 'asc' | 'desc'
- `search` string
- `status` string
- `tags` string
- `domains` string
- `created_from` string, date-time
- `created_to` string, date-time
- `batch_id` string
- `task_initiated` boolean
- `playground` boolean
- `proxy` boolean
- `extra_stealth` boolean
- `profile_name` string

## Response `200`

Paginated sessions history retrieved successfully.

- SessionHistoryPageResponse — Paginated session history listing response.
  - `data` object
    - `sessions` SessionHistoryPageItem[], required — Session records in the current page.
      - `id` string, required — Unique session identifier.
      - `status` string, required — Current session status.
      - `tags` string[], nullable — Tags associated with the session.
      - `headless` boolean, required — Whether the session ran in headless mode.
      - `recording` boolean, required — Whether recording was enabled for the session.
      - `used_credits` union, required — Credits consumed by the session (number or decimal string), or `N/A` while still running.
        - number
        - string
        - 'N/A'
      - `proxy_bytes` number, nullable — Proxy bandwidth used in bytes.
      - `proxy_type` string, nullable — Proxy type configured for the session.
      - `steps` number, nullable — Number of AI/browser steps recorded.
      - `duration` number, nullable — Session duration in seconds.
      - `created_at` string, date-time, required — Session creation timestamp in UTC ISO 8601 format.
      - `user_configuration` object, required — Full user configuration payload saved for the session.
      - `task_initiated` boolean, required — Whether the session was initiated by a task execution.
      - `task_executions_count` number, required — Number of non-internal task executions associated with this session.
      - `api_key_name` string, required — Display name of the API key that created the session.
      - `browser_ip` string, nullable, required — Browser/proxy IP observed for the session.
      - `domains` string[], nullable — Domains observed during session execution.
    - `total` number, required — Total number of matching sessions.
    - `page` number, required — Current page number.
    - `total_pages` number, required — Total number of pages.

## Other responses

- `400` — Invalid query parameters (for example unsupported limit or sort options).
- `500` — Internal Server Error

## Changes

- **2026-04-29** `d0f5aa64f9f4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/sessions/get.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) · [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/anchorbrowser/anchorbrowser-api/revisions/d0f5aa64f9f4/schema)