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

# Get Run Events

`GET /runs/{run_id}/events`

## Request

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

Paginated event read. `after` is the event id cursor — clients
doing periodic polls pass back the highest id they've seen to get only
the delta. Default 0 returns from the start.

## Path parameters

- `run_id` string, uuid, required

## Query parameters

- `limit` integer
- `after` integer
- `include_output` boolean

## Response `200`

Successful Response

- RunEventsResponse
  - `events` RunEvent[], required
    - `runId` string, uuid, required
    - `id` integer, required
    - `ts` string, date-time, required
    - `type` string, required
    - `data` object, required
  - `nextAfter` integer, nullable
  - `hasMore` boolean

## 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)