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>"
    }
  ],
  "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.

​
id
string
required
​
task
string
required
​
output
string | null
required
​
status
enum<string>
required

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
Available options:
created,
running,
finished,
stopped,
paused,
failed
​
created_at
string
required
​
steps
object[]
required

evaluation_previous_goal: Assessment of the previous goal's completion next_goal: Description of what the next step aims to achieve

​
live_url
string | null
​
finished_at
string | null
​
browser_data
object | 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.

Was this page helpful?