---
title: "List Session Recording Downloads"
method: GET
path: "/v1/sessions/{id}/recording/downloads"
---

# List Session Recording Downloads

`GET /v1/sessions/{id}/recording/downloads`

Returns the per-page download status for a session, with a short-lived signed URL for each completed page on standard (non-BYOS) projects.

## Path parameters

- `id` string, uuid, required

## Response `200`

The request has succeeded.

- object
  - `downloads` RecordingDownload[], required
    - `pageId` string, required — Recorded page (tab) within the session, e.g. "0", "1".
    - `status` 'NOT_REQUESTED' | 'PENDING' | 'COMPLETED' | 'FAILED', required — Per-page MP4 assembly state. `NOT_REQUESTED`: no download has been requested for the session yet. `PENDING`: assembly is enqueued or in progress. `COMPLETED`: the MP4 is ready. `FAILED`: assembly failed; POST again to retry.
    - `downloadUrl` string — Short-lived signed CDN URL, re-minted each GET. Present only when COMPLETED on a standard (non-BYOS) project.
    - `completedAt` string, date-time — When the MP4 was created. Present only when COMPLETED on a standard (non-BYOS) project.

## Other responses

- `404` — The session was not found, or it has no recording.
- `409` — The session has not ended. Recording downloads are available only after a session completes.
- `410` — The session's recording has aged out of its retention window and can no longer be assembled.
- `422` — Recording was disabled for this session (`recordSession: false`), so there is nothing to download.
- `502` — Failed to reach the recording service. Retry the request.

## Changes

- **2026-07-16** `071820a68a60` — 1 info
  - added the non-success response with the status `422`
- **2026-07-14** `832b22144edf` — 1 info
  - endpoint added

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

---

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