List Subaccount Usage

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

{
  "data": [
    {
      "blockedReasons": [
        "monthlySpendLimit"
      ],
      "computedAt": "2024-04-25T14:45:00Z",
      "credits": {
        "breakdown": {
          "aiCredits": 125.75,
          "browserCredits": 30.5,
          "captchaCredits": 12,
          "filesCredits": 45.25,
          "proxyCredits": 60
        },
        "estimated": 273.5,
        "limit": 500,
        "remaining": 226.5,
        "settled": 200,
        "used": 273.5
      },
      "isBlocked": true,
      "period": {
        "endsAt": "2024-05-01T00:00:00Z",
        "startedAt": "2024-04-01T00:00:00Z"
      },
      "runs": {
        "active": 3,
        "blocked": true,
        "limit": 10
      },
      "spaces": {
        "blocked": true,
        "limit": 5,
        "used": 5
      },
      "subaccountId": "subacct-9f8b7c6d"
    }
  ],
  "nextCursor": "eyJwYWdlIjoyfQ=="
}

List current usage snapshots for subaccounts. Prefer GET /v1/subaccounts?include=usage when you also need subaccount metadata.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Query parameters

cursorstringOptional>=1 character

limitintegerOptional<=200Defaults to 50

Response

datalist of objects

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error