GET
/
api
/
v1
/
task
/
{task_id}
/
status
import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

task_id = 'task_1234567890abcdef'
response = requests.get(f'{BASE_URL}/task/{task_id}/status', headers=HEADERS)
status = response.json()
print(f"Task status: {status}")

"finished"

Returns just the current status of a task (created, running, finished, stopped, paused, or failed). This is more lightweight than the full task details endpoint.

​
Path Parameters

​
task_id
string
required

ID of the task to check status for

​
Response

The endpoint returns the status as a simple string value (not wrapped in an object).

import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

task_id = 'task_1234567890abcdef'
response = requests.get(f'{BASE_URL}/task/{task_id}/status', headers=HEADERS)
status = response.json()
print(f"Task status: {status}")

"finished"

​
Status Values

The status field can have one of the following values:

  • created: Task is initialized but not yet started
  • running: Task is currently executing
  • finished: Task has completed successfully
  • stopped: Task was manually stopped
  • paused: Task execution is temporarily paused
  • failed: Task encountered an error and could not complete

​
Use Cases

This endpoint is useful for:

  • Polling task status without retrieving full task details
  • Lightweight status checks in monitoring applications
  • Quick status verification before making other API calls
  • Building real-time dashboards with minimal data transfer

Use this endpoint instead of the full task details endpoint when you only need to check the current status, as it’s much faster and uses less bandwidth.