Skip to main content
GET
/
v1
/
sessions
/
{id}
Get Session
curl --request GET \
  --url https://api.example.com/v1/sessions/{id}

Documentation Index

Fetch the complete documentation index at: https://docs.reader.dev/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve the current status of a browser session.

​
Request

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key

​
Path Parameters

ParameterTypeDescription
idstringSession ID

​
Response

​
200 OK

{
  "success": true,
  "data": {
    "sessionId": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "active",
    "createdAt": "2026-04-30T12:00:00.000Z",
    "expiresAt": "2026-04-30T13:00:00.000Z"
  }
}

​
Status Values

StatusDescription
activeSession is running, CDP endpoint is connectable
stoppedSession was explicitly stopped
expiredSession reached its timeout limit

​
Errors

CodeStatusDescription
session_not_found404Session does not exist or belongs to another workspace