List Usage

GET

/v2/subaccounts/usage

GET

/v2/subaccounts/usage

$ curl https://api.bctrl.ai/v2/subaccounts/usage \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "data": [
3     {
4       "blocked": true,
5       "blockedReasons": [
6         "monthly_spend_limit"
7       ],
8       "breakdown": {
9         "aiMicroUsd": 1250000,
10         "browserMicroUsd": 300000,
11         "captchaMicroUsd": 450000,
12         "proxyMicroUsd": 600000
13       },
14       "computedAt": "2024-06-15T12:00:00Z",
15       "cycle": {
16         "endsAt": "2024-06-30T23:59:59Z",
17         "startedAt": "2024-06-01T00:00:00Z"
18       },
19       "runs": {
20         "active": 12,
21         "blocked": true,
22         "maxActive": 15
23       },
24       "spaces": {
25         "blocked": true,
26         "max": 5,
27         "used": 5
28       },
29       "spend": {
30         "blocked": true,
31         "currency": "usd",
32         "estimatedMicroUsd": 26000000,
33         "limitMicroUsd": 25000000,
34         "remainingMicroUsd": 0,
35         "settledMicroUsd": 24000000,
36         "usedMicroUsd": 26000000
37       },
38       "subaccountId": "subacct-9f8b7c6d"
39     }
40   ],
41   "nextCursor": "eyJwYWdlIjoyfQ=="
42 }

List current usage snapshots for subaccounts. Use this for tenant spend and quota monitoring.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Response

Default Response

datalist of objects

nextCursorstring or null