GET
/
api
/
v1
/
task
/
{task_id}
curl --request GET \
  --url https://api.browser-use.com/api/v1/task/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "task": "<string>",
  "live_url": "<string>",
  "output": "<string>",
  "status": "created",
  "created_at": "2023-11-07T05:31:56Z",
  "finished_at": "2023-11-07T05:31:56Z",
  "steps": [
    {
      "id": "<string>",
      "step": 123,
      "evaluation_previous_goal": "<string>",
      "next_goal": "<string>",
      "url": "<string>"
    }
  ],
  "browser_data": {
    "cookies": [
      {}
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
task_id
string
required

Response

200
application/json

Successful Response

output: Final output or result of the task (if completed) live_url: URL to view live task execution. To preview the url you can directly integrate it in <iframe> tag. For example: <iframe src={live_url} width="600" height="450"></iframe> Which will display the task execution and allows you to control the agent live. It is pure VNC implementation.

browser_data: Browser session data from the task (cookies). To enable this feature, you need to set save_browser_data = True in the request.