Get Subaccount Budget

GET

/v1/subaccounts/:id/budget

Get the current budget and usage snapshot for one subaccount. Use this to understand spend against the tenant or environment that owns the work.

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

Default Response

blockedboolean

cycleobject

maxActiveRunsinteger or null<=9007199254740991

monthlyCreditLimitMicroUsdinteger or null0-9007199254740991

subaccountIdstring>=1 character

usageobject

1	{
2	"blocked": false,
3	"cycle": {
4	"periodEnd": "2024-06-30T23:59:59Z",
5	"periodStart": "2024-06-01T00:00:00Z"
6	},
7	"maxActiveRuns": 50,
8	"monthlyCreditLimitMicroUsd": 5000000000,
9	"subaccountId": "subacct-12345",
10	"usage": {
11	"activeRunCount": 12,
12	"breakdown": {
13	"aiMicroUsd": 1200000000,
14	"browserMicroUsd": 800000000,
15	"captchaMicroUsd": 300000000,
16	"proxyMicroUsd": 400000000
17	},
18	"remainingMicroUsd": 2300000000,
19	"settledMicroUsd": 1500000000,
20	"unsettledEstimateMicroUsd": 700000000,
21	"usedMicroUsd": 2200000000
22	}
23	}

1	curl https://api.bctrl.ai/v1/subaccounts/id/budget \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"