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.

GET /boxes/sizes

List Box Sizes

JavaScript

const options = {method: 'GET'};

fetch('https://api.browser-use.com/api/v3/boxes/sizes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://api.browser-use.com/api/v3/boxes/sizes

import requests

url = "https://api.browser-use.com/api/v3/boxes/sizes"

response = requests.get(url)

print(response.text)

200

{
  "sizes": [
    {
      "vcpu": 123,
      "ram_gb": 123,
      "disk_gb": 123,
      "daily_usd": 123,
      "min_balance_usd": 123
    }
  ]
}

Response

200 - application/json

Successful Response

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.

sizes · BoxSizeSpecView · object[] · required

Show child attributes

default · enum<string> · required

Available options: small, medium, large