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

# List Box Sizes

> Public catalog of available box sizes for the deploy picker.

Static data — no auth, no DB. Lives server-side (instead of being
hardcoded in the frontend) so re-tiering or running a promo is a
one-file edit in `sizing.py` with no frontend redeploy needed.



## OpenAPI

````yaml /cloud/openapi/v3.json get /boxes/sizes
openapi: 3.1.0
info:
  title: Browser Use Public API v3
  summary: Browser Use session-based agent API (v3)
  version: 3.0.0
servers:
  - url: https://api.browser-use.com/api/v3
    description: Production server
security: []
paths:
  /boxes/sizes:
    get:
      tags:
        - Boxes
      summary: List Box Sizes
      description: |-
        Public catalog of available box sizes for the deploy picker.

        Static data — no auth, no DB. Lives server-side (instead of being
        hardcoded in the frontend) so re-tiering or running a promo is a
        one-file edit in `sizing.py` with no frontend redeploy needed.
      operationId: list_box_sizes_boxes_sizes_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BoxSizeListResponse'
components:
  schemas:
    BoxSizeListResponse:
      properties:
        sizes:
          items:
            $ref: '#/components/schemas/BoxSizeSpecView'
          type: array
          title: Sizes
        default:
          type: string
          enum:
            - small
            - medium
            - large
          title: Default
      type: object
      required:
        - sizes
        - default
      title: BoxSizeListResponse
      description: |-
        Catalog of available size tiers, returned to the deploy picker.

        Keeping the list server-side (instead of hardcoding prices in the
        frontend) means the day we re-tier or run a promo, we don't have
        to ship a frontend deploy. Just edit `sizing.py`.
    BoxSizeSpecView:
      properties:
        name:
          type: string
          enum:
            - small
            - medium
            - large
          title: Name
        vcpu:
          type: integer
          title: Vcpu
        ram_gb:
          type: integer
          title: Ram Gb
        disk_gb:
          type: integer
          title: Disk Gb
        daily_usd:
          type: number
          title: Daily Usd
        min_balance_usd:
          type: number
          title: Min Balance Usd
      type: object
      required:
        - name
        - vcpu
        - ram_gb
        - disk_gb
        - daily_usd
        - min_balance_usd
      title: BoxSizeSpecView
      description: |-
        User-visible spec sheet for one size tier. Returned alongside
        BoxView so the UI can render the tooltip ("2 vCPU · 4 GB · 20 GB")
        without a second round trip + so the picker on /bux can show all
        three rows without us hardcoding prices in the frontend.

````