---
title: "Get Run Status"
method: GET
path: "/runs/{run_id}/status"
tags: ["Runs"]
---

# Get Run Status

`GET /runs/{run_id}/status`

## Request

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

Minimal status poll (see RunStatusResponse). POLL rate bucket: selects
ONLY the status/project columns — a 2s poll never drags the task/result
text (TOAST reads) that GET /runs/{id} pays. Poll until terminal, then
fetch the full summary once.

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- RunStatusResponse: Minimal poll target: just the run's status. Poll this until terminal (cheap indexed lookup, tiny payload — never the task/result text), then fetch the full RunSummary once via GET /runs/{id}. Mirrors v2's GET /tasks/{id}/status.
  - `status` 'queued' | 'dispatching' | 'running' | 'completed' | 'failed' | 'cancelled', required

## Other responses

- `403`: Zero Data Retention is enabled on the project (V4 unsupported).
- `404`: Run, session, workspace, or profile 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)