Get Task Status

Lightweight endpoint optimized for polling task status.

Returns only the task status, output, and cost without loading steps, files, or session details. Use this endpoint for efficient polling instead of GET /tasks/.

Recommended polling pattern:

1. POST /tasks to create a task
2. Poll GET /tasks//status until status is ‘finished’ or ‘stopped’
3. GET /tasks/ once at the end for full details including steps

GET /tasks/{task_id}/status

Get Task Status

JavaScript

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

curl --request GET \
  --url https://api.browser-use.com/api/v2/tasks/{task_id}/status \
  --header 'X-Browser-Use-API-Key: <api-key>'

import requests

url = "https://api.browser-use.com/api/v2/tasks/{task_id}/status"

headers = {"X-Browser-Use-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "output": "<string>",
  "finishedAt": "2023-11-07T05:31:56Z",
  "isSuccess": true,
  "cost": "<string>"
}

{
  "detail": "Task not found"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

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

Path Parameters

task_id · string<uuid> · required

Response

200

application/json

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, failed, 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

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$