Skip to main content
GET
/
browser
/
sessions
List Sessions
curl --request GET \
  --url https://api.example.com/browser/sessions
{
  "sessions": [
    {}
  ]
}

​
Overview

Returns all currently-active browser sessions owned by the authenticated user. Expired or destroyed sessions are not returned.

​
Example Request

curl -X GET "https://api.scrapengine.io/api/v1/browser/sessions" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY"

​
Response

​
Success Response (200)

​
sessions
object[]
Array of session objects. Each has the same shape as the response of POST /browser/sessions: id, status, cdpUrl, liveViewUrl, capabilities, extensions, proxy, createdAt, expiresAt.
Example Response: 
{
  "sessions": [
    {
      "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
    }
  ]
}

​
Error Responses

StatusDescription
401Unauthorized — invalid or missing API key.