GET
/
api
/
v1
/
balance
import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

response = requests.get(f'{BASE_URL}/balance', headers=HEADERS)
balance = response.json()['balance']
print(f"Current API credit balance: {balance}")
{
  "balance": "5000"
}

Returns the user’s current API credit balance, which includes both monthly subscription credits and any additional purchased credits.

Response

balance
string

The current number of API credits available, with the value in cents (0.01 USD = 1 credit).

import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

response = requests.get(f'{BASE_URL}/balance', headers=HEADERS)
balance = response.json()['balance']
print(f"Current API credit balance: {balance}")
{
  "balance": "5000"
}

API Credit Usage

Each task execution consumes API credits based on the following factors:

  1. Task Duration: Longer running tasks consume more credits
  2. LLM Model: More powerful models consume more credits
  3. Browser Features: Features like proxy usage and adblock may affect credit consumption
  4. Task Complexity: More complex tasks with many steps consume more credits

You can monitor your credit usage through the Browser Use Cloud dashboard or by using the Check Balance endpoint.

If your balance reaches zero, new task executions will be rejected until you add more credits or your subscription renews.