---
title: "List Runs"
method: GET
path: "/runs"
tags: ["Runs"]
---

# List Runs

`GET /runs`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/runs`
- Auth: API key in header `X-Browser-Use-API-Key`

## Query parameters

- `limit` integer
- `cursor` string, nullable: Keyset cursor from a prior response.
- `sessionId` string, uuid, nullable

## Response `200`

Successful Response

- RunListResponse
  - `runs` RunSummary[], required
    - `id` string, uuid, required
    - `task` string, required
    - `title` string, nullable, required
    - `model` string, required
    - `modelParams` object, nullable
    - `contextLimit` integer, required
    - `status` 'queued' | 'dispatching' | 'running' | 'completed' | 'failed' | 'cancelled', required
    - `result` string, nullable, required
    - `output` unknown
    - `outputSchema` object, nullable
    - `error` string, nullable, required
    - `sessionId` string, uuid, required
    - `workspaceId` string, uuid, nullable, required
    - `attachedFileIds` string[], nullable
    - `judgement` object, nullable
    - `totalInputTokens` integer, required
    - `totalOutputTokens` integer, required
    - `totalCostUsd` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable
  - `hasMore` boolean

## Other responses

- `400`: Malformed pagination cursor.
- `403`: Zero Data Retention is enabled on the project (V4 unsupported).
- `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)