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

# Get Sessions History

`GET /v1/sessions/history`

Retrieves session usage analytics for the authenticated team.

## Query parameters

- `from_date` string, date-time
- `to_date` string, date-time
- `granularity` 'hour' | 'day' | 'week' | 'month'
- `metrics` union
  - string
  - string[]
- `page` integer
- `limit` integer

## Response `200`

Session history analytics retrieved successfully.

- SessionHistoryResponse
  - `data` SessionHistoryDataPoint[] — Historical data points.
    - `date` string — Date/time period for this data point.
    - `session_count` number — Number of sessions created in this period.
    - `proxy_bytes` number — Total proxy bytes used in this period.
    - `ai_steps` number — Total AI steps taken in this period.
    - `session_hours` number — Total session hours in this period (duration/3600).
    - `credits_used` number — Total credits used in this period.
    - `screenshots` number — Total screenshots taken in this period.
    - `network_bytes_total` number — Total network bytes sent and received in this period.
  - `summary` SessionHistorySummary
    - `total_sessions` number — Total number of sessions in the time range.
    - `total_proxy_bytes` number — Total proxy bytes used in the time range.
    - `total_ai_steps` number — Total AI steps taken in the time range.
    - `total_session_hours` number — Total session hours in the time range.
    - `total_credits_used` number — Total credits used in the time range.
    - `total_screenshots` number — Total screenshots taken in the time range.
    - `total_network_bytes_total` number — Total network bytes sent and received in the time range.
  - `pagination` SessionHistoryPagination
    - `current_page` integer
    - `total_pages` integer
    - `total_records` integer
    - `has_next` boolean
    - `has_prev` boolean

## Other responses

- `400` — Bad Request
- `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/history/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)