> ## 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 Proxy

> Get the current proxy configuration for a browser session.

## Overview

Returns the session's current proxy state — whether a proxy is active, which provider and location it uses, and whether the exit IP is sticky. Returns `enabled: false` for sessions running without a managed proxy.

## Path Parameters

<ParamField path="id" type="string" required={true}>
  Browser session ID (UUID).
</ParamField>

## Example Request

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

## Response

### Success Response (200)

<ResponseField name="enabled" type="boolean">
  Whether a proxy is currently active for this session.
</ResponseField>

<ResponseField name="provider" type="string">
  Proxy provider — `oxylabs` or `evomi`. Absent when `enabled` is false.
</ResponseField>

<ResponseField name="location" type="string">
  Country code of the exit IP.
</ResponseField>

<ResponseField name="sticky" type="boolean">
  Whether the exit IP is held for the life of the session.
</ResponseField>

**Example Response:**

```json theme={null}
{
  "enabled": true,
  "provider": "oxylabs",
  "location": "us",
  "sticky": true
}
```

### Error Responses

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