Skip to main content
GET
/
browser
/
sessions
/
{id}
Get Session
curl --request GET \
  --url https://api.example.com/browser/sessions/{id}
{
  "id": "<string>",
  "status": "<string>",
  "cdpUrl": "<string>",
  "liveViewUrl": "<string>",
  "capabilities": [
    "<string>"
  ],
  "extensions": [
    "<string>"
  ],
  "proxy": {},
  "createdAt": 123,
  "expiresAt": 123,
  "pages": [
    {}
  ]
}

​
Overview

Returns the full session record, including the current list of open pages (URL + title). Use this to re-fetch cdpUrl / liveViewUrl if the client misplaced them.

​
Path Parameters

​
id
string
required
Browser session ID (UUID). Create via POST /browser/sessions.

​
Example Request

curl -X GET "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY"

​
Response

​
Success Response (200)

Same shape as the POST /browser/sessions response, with an additional pages field.
​
id
string
Session ID (UUID).
​
status
string
Current session state.
​
cdpUrl
string
Chrome DevTools Protocol WebSocket URL.
​
liveViewUrl
string
Shareable live-view URL.
​
capabilities
string[]
Enabled capabilities.
​
extensions
string[]
Loaded extension IDs.
​
proxy
object
Managed proxy info — enabled, provider, location, sticky.
​
createdAt
integer
Unix epoch ms when the session was created.
​
expiresAt
integer
Unix epoch ms when the session auto-expires.
​
pages
object[]
Array of { url, title } for currently-open tabs.
Example Response: 
{
  "id": "baa3f390-fa6e-4a24-b84a-a575a5f3a9c7",
  "status": "ready",
  "cdpUrl": "wss://cdp.scrapengine.io/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7",
  "liveViewUrl": "https://live.scrapengine.io/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7",
  "capabilities": ["stealth"],
  "extensions": [],
  "createdAt": 1714000000000,
  "expiresAt": 1714001800000,
  "pages": [
    { "url": "https://example.com/", "title": "Example Domain" }
  ]
}

​
Error Responses

StatusDescription
401Unauthorized — invalid or missing API key.
404Session not found or not owned by the caller.