Get Task Status | Browser Use Cloud Docs

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/{task_id}.

Recommended polling pattern:

POST /tasks to create a task
Poll GET /tasks/{task_id}/status until status is ‘finished’ or ‘stopped’
GET /tasks/{task_id} once at the end for full details including steps

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/{task_id}. Recommended polling pattern: 1. POST /tasks to create a task 2. Poll GET /tasks/{task_id}/status until status is 'finished' or 'stopped' 3. GET /tasks/{task_id} once at the end for full details including steps

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

statusenum

Current status of the task

Allowed values:

outputstring or null

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

finishedAtdatetime or null

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

isSuccessboolean or null

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

coststring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

Total cost of the task in USD

1	import requests
2
3	url = "https://api.browser-use.com/api/v2/tasks/task_id/status"
4
5	headers = {"X-Browser-Use-API-Key": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"id": "string",
3	"status": "created",
4	"output": "string",
5	"finishedAt": "2024-01-15T09:30:00Z",
6	"isSuccess": true,
7	"cost": "string"
8	}

Authentication

Path parameters

Response

Errors