Check Balance | Browser Use Cloud Docs

Returns the user's current API credit balance, which includes both monthly subscription credits and any additional purchased credits. Required for monitoring usage and ensuring sufficient credits for task execution.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

Successful Response

balancestringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

monthly_credits_balancestringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

additional_credits_balancestringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

rate_limitinteger

plan_infomap from strings to nullable strings or booleans

authenticatedboolean or nullDefaults to true

1	import requests
2
3	url = "https://api.browser-use.com/api/v1/balance"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"balance": "string",
3	"monthly_credits_balance": "string",
4	"additional_credits_balance": "string",
5	"rate_limit": 1,
6	"plan_info": {},
7	"authenticated": true
8	}