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

# Get sandbox by ID



## OpenAPI

````yaml openapi.json GET /api/sandbox/{id}
openapi: 3.0.1
info:
  title: Hyperbrowser API
  version: 1.0.0
servers:
  - url: https://api.hyperbrowser.ai
    description: Production server
security: []
paths:
  /api/sandbox/{id}:
    get:
      tags:
        - Sandboxes
      summary: Get sandbox by ID
      parameters:
        - name: id
          in: path
          required: true
          description: Sandbox ID
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Sandbox details, including a runtime session token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SandboxDetail'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SandboxDetail:
      type: object
      properties:
        id:
          type: string
          format: uuid
        teamId:
          type: string
        status:
          $ref: '#/components/schemas/SandboxStatus'
        startTime:
          type: number
          nullable: true
          description: Start timestamp in epoch milliseconds.
        endTime:
          type: number
          nullable: true
          description: End timestamp in epoch milliseconds.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        closeReason:
          type: string
          nullable: true
        creditsUsed:
          type: number
          nullable: true
        region:
          $ref: '#/components/schemas/SessionRegion'
        vcpus:
          type: integer
          nullable: true
        memMiB:
          type: integer
          nullable: true
        diskSizeMiB:
          type: integer
          nullable: true
        timeoutMinutes:
          type: integer
          nullable: true
        network:
          $ref: '#/components/schemas/SandboxNetworkPolicy'
        sessionUrl:
          type: string
          description: Dashboard URL for this sandbox.
        duration:
          type: number
          description: Total runtime in milliseconds (0 while running).
        proxyBytesUsed:
          type: number
        runtime:
          $ref: '#/components/schemas/SandboxRuntimeTarget'
        exposedPorts:
          type: array
          items:
            $ref: '#/components/schemas/SandboxExposedPort'
        token:
          type: string
          nullable: true
          description: >-
            Sandbox runtime session token (24h TTL). Null when the sandbox is
            unavailable.
        tokenExpiresAt:
          type: string
          format: date-time
          nullable: true
      required:
        - id
        - status
        - region
        - runtime
        - exposedPorts
    SandboxStatus:
      type: string
      enum:
        - active
        - closed
        - close-error
        - error
      description: Current sandbox lifecycle status.
    SessionRegion:
      type: string
      enum:
        - us
        - us-central
        - us-west
        - us-east
        - asia-south
        - europe-west
    SandboxNetworkPolicy:
      type: object
      description: Effective outbound network policy for a sandbox.
      properties:
        allowInternetAccess:
          type: boolean
          default: true
          description: Whether general outbound internet access is allowed.
        allowOut:
          type: array
          items:
            type: string
          description: >-
            Outbound allow rules. Each entry is an IPv4 address, CIDR range, or
            domain.
        denyOut:
          type: array
          items:
            type: string
          description: Outbound deny rules. Each entry is an IPv4 address or CIDR range.
      required:
        - allowInternetAccess
        - allowOut
        - denyOut
    SandboxRuntimeTarget:
      type: object
      description: >-
        Connection details for the sandbox runtime API (process execution,
        files, terminals).
      properties:
        transport:
          type: string
          enum:
            - regional_proxy
        host:
          type: string
          description: Regional runtime origin.
        baseUrl:
          type: string
          description: Base URL for runtime API requests for this sandbox.
      required:
        - transport
        - host
        - baseUrl
    SandboxExposedPort:
      type: object
      properties:
        port:
          type: integer
          minimum: 1
          maximum: 65535
        auth:
          type: boolean
          description: Whether requests to the exposed URL require authentication.
        url:
          type: string
          description: Public URL that routes to the exposed port.
        browserUrl:
          type: string
          description: >-
            URL that bootstraps browser access. For authenticated ports this
            includes a short-lived grant token.
        browserUrlExpiresAt:
          type: string
          format: date-time
          nullable: true
          description: Expiry of the browser bootstrap grant, if auth is enabled.
      required:
        - port
        - auth
        - url
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````