API Referencev2 API (Current)Tasks

Get Task

Get detailed task information including status, progress, steps, and file outputs.

Authentication

X-Browser-Use-API-Keystring
API Key authentication via header

Path Parameters

task_idstringRequiredformat: "uuid"

Response

Successful Response
idstringformat: "uuid"
Unique identifier for the task
sessionIdstringformat: "uuid"
llmstring
The LLM model used for this task represented as a string
taskstring

The task prompt/instruction given to the agent

statusenum
Current status of the task execution
Allowed values:
createdAtdatetime
Naive UTC timestamp when the task was created
stepslist of objects
outputFileslist of objects
startedAtdatetime or null

Naive UTC timestamp when the task was started (None if task has not started yet)

finishedAtdatetime or null

Naive UTC timestamp when the task completed (None if still running)

metadatamap from strings to any or null
Optional additional metadata associated with the task set by the user
outputstring or null

Final output/result of the task

browserUseVersionstring or null

Version of browser-use used for this task (older tasks may not have this set)

isSuccessboolean or null

Whether the task was successful based on the agent’s self-reported output (less reliable than the judge)

judgementstring or null
Stringified JSON object containing the full report from the judge
judgeVerdictboolean or null

Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled)

Errors