Get Task | Browser Use Cloud Docs

1 import requests 2 3 url = "https://api.browser-use.com/api/v1/task/task_id" 4 5 headers = {"Authorization": "Bearer <token>"} 6 7 response = requests.get(url, headers=headers) 8 9 print(response.json())

1 { 2 "id": "string", 3 "task": "string", 4 "output": "string", 5 "status": "created", 6 "created_at": "2024-01-15T09:30:00Z", 7 "steps": [ 8 { 9 "id": "string", 10 "step": 1, 11 "evaluation_previous_goal": "string", 12 "next_goal": "string", 13 "url": "string" 14 } 15 ], 16 "live_url": "string", 17 "finished_at": "2024-01-15T09:30:00Z", 18 "browser_data": { 19 "cookies": [ 20 {} 21 ] 22 }, 23 "user_uploaded_files": [ 24 "string" 25 ], 26 "output_files": [ 27 "string" 28 ], 29 "public_share_url": "string", 30 "metadata": {} 31 }

Returns comprehensive information about a task, including its current status, steps completed, output (if finished), and other metadata.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

task_idstringRequiredformat: "uuid"

Response

Successful Response

idstringformat: "uuid"

taskstring

outputstring or null

statusenum

Enumeration of possible task states.

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

Enumeration of possible task states. - 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

created_atdatetime

stepslist of objects

live_urlstring or null

finished_atdatetime or null

browser_dataobject or null

cookies: List of cookies from the browser session

This field is only available if save_browser_data is set to True in the request.

user_uploaded_fileslist of strings or null

output_fileslist of strings or null

public_share_urlstring or null

metadatamap from strings to nullable strings or null

Authentication

Path Parameters

Response

Errors