API Referencev2 API (Current)Browsers

Get Browser Session

Get detailed browser session information including status and URLs.

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:
timeoutAtdatetime
Timestamp when the session will timeout
startedAtdatetime
Timestamp when the session was created and started
liveUrlstring or null

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

cdpUrlstring or null
Chrome DevTools Protocol URL for browser automation
finishedAtdatetime or null

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

Errors