API ReferenceAPI v2Browsers

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)

proxyUsedMbstring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"Defaults to 0
Amount of proxy data used in MB
proxyCoststring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"Defaults to 0
Cost of proxy usage in USD
browserCoststring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"Defaults to 0
Cost of browser session hosting in USD

Errors