Skip to main content
GET
/
boxes
/
sizes
List Box Sizes
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));
{
  "sizes": [
    {
      "name": "small",
      "vcpu": 123,
      "ram_gb": 123,
      "disk_gb": 123,
      "daily_usd": 123,
      "min_balance_usd": 123
    }
  ],
  "default": "small"
}

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.

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
default
enum<string>
required
Available options:
small,
medium,
large