Skip to main content
GET
Get Browsercode Run

Authorizations

X-Browser-Use-API-Key
string
header
required

Path Parameters

run_id
string
required

Response

Successful Response

A browsercode run, as returned by POST /runs and GET /runs/{id}.

On completion: result is the short answer string. Real/structured output is a FILE — GET /runs/{id}/files?kind=output (browsercode has no structuredOutput param; you put the shape in the task and fetch the file).

id
string
required

Run id, e.g. "run_...".

status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
stopped
sessionId
string<uuid>
required

The conversation this run belongs to.

workspaceId
string<uuid>
required

The run's workspace; its files live here.

model
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
agent
enum<string>
default:browsercode

Always 'browsercode'.

Available options:
browser-use,
browsercode
browserId
string<uuid> | null

The browser this run used. Null until provisioned; persists after completion.

result
string | null

Short answer summary. Null until the run completes.

error
string | null

Failure reason, if the run failed.

totalInputTokens
integer
default:0
totalOutputTokens
integer
default:0
totalCostUsd
string
default:0

USD billed to the project.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
missingFileIds
string<uuid>[]