---
title: "Get session capture metadata"
method: GET
path: "/api/sessions/{sessionId}/capture"
tags: ["Sessions"]
---

# Get session capture metadata

`GET /api/sessions/{sessionId}/capture`

## Request

- Base URL: `https://aximo.autify.com`
- URL: `https://aximo.autify.com/api/sessions/{sessionId}/capture`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/autify/apis/aximo-api/docs/api/sessions/:sessionId/capture/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns CDP-derived capture metadata recorded during a session: ordered
events (actions, navigations, network XHR/fetch, console, exceptions,
snapshot triggers), the browser context, and the post-session storage
state. Only available when the organization has the CDP capture feature
flag enabled and the session ran on the desktop VM.

`404` is returned when no capture exists for the session.

## Path parameters

- `sessionId` string, uuid, required

## Query parameters

- `includeSnapshots` 'none' | 'metadata' | 'full'
- `includeCookieValues` boolean

## Response `200`

Session capture blob.

- SessionCapture
  - `sessionId` string, uuid, required
  - `platform` string, required
  - `startedAt` string, date-time, nullable
  - `endedAt` string, date-time, nullable
  - `browserContext` object, nullable: UA, viewport, locale, timezone captured at session start.
  - `events` object[]: Ordered, timestamped events: action_started/completed, page_navigated, page_lifecycle, request, response, console, exception, dialog_opened, snapshot_captured, target_attached, target_detached.
    - `type` string, required
    - `ts` integer, required: Epoch millis (Date.now()) when the event was recorded inside the VM.
  - `storageState` object, nullable: Cookies and localStorage captured at session end.
  - `snapshotCount` integer, required: Number of DOM+AX snapshots captured (one per `screenshot` tool call and per page-load).
  - `snapshotsPrefix` string, nullable: S3 prefix for snapshot blobs. Null while snapshots are persisted inline.
  - `snapshots` object[]: Inline DOM + accessibility-tree snapshots, in capture order. Each entry pairs a pixel-level event (a `screenshot` tool call or a `Page.lifecycleEvent: load`) with the structural state of the page at that moment. Large — expect single-MB responses on long sessions.
    - `id` string, uuid, required
    - `ts` integer, required: Epoch ms when the snapshot was taken
    - `messageId` string, uuid, nullable: AgentMessage that triggered the snapshot, when trigger was `screenshot`.
    - `trigger` 'screenshot' | 'page_load', required
    - `targetId` string, required: CDP target (tab/iframe) id
    - `url` string, required
    - `title` string
    - `dom` unknown
    - `axTree` unknown
  - `truncated` boolean, required: True if the event buffer reached its cap and dropped tail events.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400`: Invalid query parameter (e.g. unknown `includeSnapshots` value).
- `401`: Missing or invalid API key.
- `404`: Session or capture not found.
- `429`: Rate limit exceeded — e.g. the daily session limit was reached for the organization, or too many API requests were sent in a short window (retry after the number of seconds in the `Retry-After` header).
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/autify/apis/aximo-api.md) - [All operations](https://skmtc.dev/autify/apis/aximo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autify/apis/aximo-api/revisions/590722011284?raw)