Get Session | Browser Use Cloud Docs

1 curl https://api.browser-use.com/api/v2/sessions/session_id \ 2 -H "X-Browser-Use-API-Key: <apiKey>"

1 { 2 "id": "string", 3 "status": "active", 4 "startedAt": "2024-01-15T09:30:00Z", 5 "tasks": [ 6 { 7 "id": "string", 8 "sessionId": "string", 9 "llm": "string", 10 "task": "string", 11 "status": "created", 12 "createdAt": "2024-01-15T09:30:00Z", 13 "startedAt": "2024-01-15T09:30:00Z", 14 "finishedAt": "2024-01-15T09:30:00Z", 15 "metadata": {}, 16 "output": "string", 17 "browserUseVersion": "string", 18 "isSuccess": true, 19 "judgement": "string", 20 "judgeVerdict": true 21 } 22 ], 23 "liveUrl": "string", 24 "finishedAt": "2024-01-15T09:30:00Z", 25 "publicShareUrl": "string" 26 }

Get detailed session information including status, URLs, and task details.

Authentication

X-Browser-Use-API-Keystring

API Key authentication via header

Path Parameters

session_idstringRequiredformat: "uuid"

Response

Successful Response

idstringformat: "uuid"

Unique identifier for the session

statusenum

Current status of the session (active/stopped)

Allowed values:

startedAtdatetime

Timestamp when the session was created and started

taskslist of objects

List of tasks associated with this session

liveUrlstring or null

URL where the browser can be viewed live in real-time

finishedAtdatetime or null

Timestamp when the session was stopped (None if still active)

publicShareUrlstring or null

Optional URL to access the public share of the session

Authentication

Path Parameters

Response

Errors