List Budgets

GET

/v1/subaccounts/budgets

GET

/v1/subaccounts/budgets

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

200Retrieved

1 {
2   "budgets": [
3     {
4       "blocked": false,
5       "cycle": {
6         "periodEnd": "2024-06-30T23:59:59Z",
7         "periodStart": "2024-06-01T00:00:00Z"
8       },
9       "maxActiveRuns": 10,
10       "monthlyCreditLimitMicroUsd": 500000000,
11       "subaccountId": "subacct-12345",
12       "usage": {
13         "activeRunCount": 3,
14         "breakdown": {
15           "aiMicroUsd": 150000000,
16           "browserMicroUsd": 100000000,
17           "captchaMicroUsd": 50000000,
18           "proxyMicroUsd": 20000000
19         },
20         "remainingMicroUsd": 180000000,
21         "settledMicroUsd": 300000000,
22         "unsettledEstimateMicroUsd": 20000000,
23         "usedMicroUsd": 320000000
24       }
25     }
26   ]
27 }

List budget snapshots across subaccounts in the organization. Use this for account-level spend monitoring and tenant comparisons.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Response

Default Response

budgetslist of objects