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

url = "https://api.browser-use.com/api/v1/task/{task_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.request("GET", url, headers=headers)

print(response.text)

{
"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": [
  {}
]
},
"user_uploaded_files": [
"<string>"
],
"output_files": [
"<string>"
],
"public_share_url": "<string>"
}

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

​
Path Parameters

​
task_id
string
required

ID of the task to retrieve

​
Response

​
id
string
required

The unique identifier for the task

​
task
string
required

The original task instructions

​
output
string | null
required

The final output or result from the task (if completed)

​
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

ISO 8601 timestamp of when the task was created

​
steps
TaskStepResponse · object[]
required

List of task steps with execution details

​
live_url
string | null

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.

​
finished_at
string | null

ISO 8601 timestamp of when the task finished (if completed)

​
browser_data
object | null

Browser session data (if save_browser_data was enabled)

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

​
user_uploaded_files
string[] | null

List of files uploaded by the user for this task

​
output_files
string[] | null

List of files generated during task execution

​
public_share_url
string | null

Public URL for sharing the task (if public sharing was enabled)

import requests

url = "https://api.browser-use.com/api/v1/task/{task_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.request("GET", url, headers=headers)

print(response.text)

{
"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": [
  {}
]
},
"user_uploaded_files": [
"<string>"
],
"output_files": [
"<string>"
],
"public_share_url": "<string>"
}