Skip to main content
GET
List browser runs
The response contains batches, total, and hasMore. Entries are sorted newest first. Increase skip by your page size while hasMore is true. limit defaults to 20 and is clamped to 1–100. Use a nonnegative skip. The status filter accepts processing or completed; omit it to include all stored statuses, including failed runs.

Summary rows

Rows include the run id, task count total, finished-task completed count, status, totalCreditsUsed, and available names and timestamps. Their results arrays can contain null slots. The first slot may be a partial task stub to identify the run before results arrive. Fetch run status for full task details and timelines. List summaries and detailed run snapshots have different behavior for the completed count; use status to decide whether a run is terminal. Node: client.listBrowserAgents({ limit: 20, skip: 0 }). Python: client.list_browser_agents(limit=20, skip=0) returns a dictionary.

Authorizations

Authorization
string
header
required

Use a pre.dev API key from https://pre.dev/projects/key.

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
skip
integer
default:0
Required range: x >= 0
status
enum<string>
Available options:
processing,
completed,
failed

Response

Paginated run summaries.

batches
object[]
required
total
integer
required
hasMore
boolean
required