> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapengine.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Session

> Get the full details of a single browser session, including open 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

<ParamField path="id" type="string" required={true}>
  Browser session ID (UUID). Create via `POST /browser/sessions`.
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7" \
    -H "Authorization: Bearer $SCRAPENGINE_API_KEY"
  ```
</CodeGroup>

## Response

### Success Response (200)

Same shape as the `POST /browser/sessions` response, with an additional `pages` field.

<ResponseField name="id" type="string">Session ID (UUID).</ResponseField>
<ResponseField name="status" type="string">Current session state.</ResponseField>
<ResponseField name="cdpUrl" type="string">Chrome DevTools Protocol WebSocket URL.</ResponseField>
<ResponseField name="liveViewUrl" type="string">Shareable live-view URL.</ResponseField>
<ResponseField name="capabilities" type="string[]">Enabled capabilities.</ResponseField>
<ResponseField name="extensions" type="string[]">Loaded extension IDs.</ResponseField>
<ResponseField name="proxy" type="object">Managed proxy info — `enabled`, `provider`, `location`, `sticky`.</ResponseField>
<ResponseField name="createdAt" type="integer">Unix epoch ms when the session was created.</ResponseField>
<ResponseField name="expiresAt" type="integer">Unix epoch ms when the session auto-expires.</ResponseField>
<ResponseField name="pages" type="object[]">Array of `{ url, title }` for currently-open tabs.</ResponseField>

**Example Response:**

```json theme={null}
{
  "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

| Status | Description                                   |
| ------ | --------------------------------------------- |
| `401`  | Unauthorized — invalid or missing API key.    |
| `404`  | Session not found or not owned by the caller. |
