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

# Get a session

> Retrieve an existing browser session.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/browser/session
openapi: 3.0.0
info:
  version: 1.0.0
  title: Driver API
  description: API for interacting with the Driver.dev browser network.
  contact:
    name: Driver support
    email: alex@driver.dev
servers:
  - url: https://api.driver.dev
    description: Production
security: []
tags:
  - name: Sessions
  - name: Profiles
  - name: Account
  - name: Extensions
  - name: Pools
externalDocs:
  url: https://docs.driver.dev
  description: Driver documentation
paths:
  /v1/browser/session:
    get:
      tags:
        - Sessions
      summary: Get a session
      description: Retrieve an existing browser session.
      parameters:
        - schema:
            type: string
            example: example-session-id
            description: The ID of the browser session to retrieve.
          required: true
          description: The ID of the browser session to retrieve.
          name: sessionId
          in: query
      responses:
        '200':
          description: Successfully retrieved browser session.
          content:
            application/json:
              schema:
                type: object
                properties:
                  sessionId:
                    type: string
                    description: >-
                      The session id: an opaque string; do not validate its
                      format.
                  status:
                    type: string
                    enum:
                      - starting
                      - active
                      - completed
                      - error
                    description: The status of the session.
                  servedBy:
                    type: string
                    description: The node ID that is serving this session.
                  createdAt:
                    type: string
                    description: The ISO 8601 timestamp when the session was created.
                  stoppedAt:
                    type: string
                    nullable: true
                    description: >-
                      The ISO 8601 timestamp when the session was stopped, or
                      null if it is still active.
                  cdpUrl:
                    type: string
                    nullable: true
                    format: uri
                    description: >-
                      The URL to access the Chrome DevTools Protocol for this
                      session, or null if not available.
                  note:
                    type: string
                    nullable: true
                    description: >-
                      An optional note attached to the session, or null if not
                      set.
                  bandwidthBytes:
                    type: integer
                    minimum: 0
                    description: >-
                      Bandwidth used by the session in bytes: null while it
                      runs, the metered total once it has ended (final by the
                      time a stop call returns).
                    nullable: true
                required:
                  - sessionId
                  - status
                  - servedBy
                  - createdAt
                  - stoppedAt
                  - cdpUrl
                  - note
                  - bandwidthBytes
                example:
                  sessionId: example-session-id
                  status: active
                  servedBy: this-node-id
                  createdAt: '2025-11-20T01:51:25.000Z'
                  stoppedAt: null
                  bandwidthBytes: 1048576
                  cdpUrl: >-
                    wss://sessions.driver.dev/v1/session/example-session-id/devtools/browser/uuid
                  note: null
        '401':
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                required:
                  - error
        '404':
          description: Browser session not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Session not found
                    example: Session not found
                required:
                  - error
        '500':
          description: Failed to retrieve browser session.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                required:
                  - error
        '503':
          description: The session service is unavailable.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                    example: Session service unavailable
                required:
                  - error
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: >-
        A workspace API key from Settings → API keys in the dashboard
        (https://app.driver.dev), sent as a bearer token.

````