---
title: "List Browser Session Downloads"
method: GET
path: "/browsers/{session_id}/downloads"
tags: ["Browsers"]
---

# List Browser Session Downloads

`GET /browsers/{session_id}/downloads`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/browsers/{session_id}/downloads`
- Auth: API key in header `X-Browser-Use-API-Key`

List files the browser downloaded to S3 during the session.

Pass ``includeUrls=true`` to receive presigned download URLs (15 min expiry) inline.
Files are stored at ``downloads/projects/{project_id}/sessions/{session_id}/`` in
the private bucket.

## Path parameters

- `session_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `includeUrls` boolean

## Response `200`

Successful Response

- BrowserDownloadListResponse: Paginated list of browser downloads with optional presigned URLs.
  - `files` BrowserDownloadFile[], required: List of files downloaded by the browser
    - `path` string, required: File name (basename relative to the session downloads prefix)
    - `size` integer, required: File size in bytes
    - `lastModified` string, date-time, required: When the file was last modified in S3
    - `url` string, nullable: Presigned download URL (15 min expiry). Only included when `includeUrls=true`.
  - `nextCursor` string, nullable: Cursor for the next page. Pass as the `cursor` query parameter to fetch the next page.
  - `hasMore` boolean: Whether there are more files beyond this page.

## Other responses

- `404`: Session not found
- `422`: Validation Error

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)