Skip to main content
GET
/
tasks
/
{task_id}
/
status
Get Task Status
const options = {method: 'GET', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api.browser-use.com/api/v2/tasks/{task_id}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "created",
  "output": "<string>",
  "finishedAt": "2023-11-07T05:31:56Z",
  "isSuccess": true,
  "cost": "<string>"
}

Authorizations

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

Path Parameters

​
task_id
string<uuid>
required

Response

Successful Response

Lightweight view optimized for polling. Use GET /tasks/{id}/status for efficient polling instead of GET /tasks/{id} which loads full step details.

​
id
string<uuid>
required

Unique identifier for the task

​
status
enum<string>
required

Current status of the task

Available options:
created,
started,
finished,
stopped
​
output
string | null

Final output/result of the task (null while running)

​
finishedAt
string<date-time> | null

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

​
isSuccess
boolean | null

Whether the task was successful based on the agent's self-reported output

​
cost
string | null

Total cost of the task in USD