List subaccounts | BCTRL Docs

{
  "data": [
    {
      "createdAt": "string",
      "defaultSpaceId": "string",
      "id": "V1StGXR8_Z5jdHi6B-myT",
      "limits": {
        "maxActiveRuns": 1,
        "maxSpaces": 1,
        "monthlyCreditLimit": 1.1
      },
      "name": "Production browser",
      "status": "active",
      "updatedAt": "string",
      "archivedAt": "string",
      "externalId": "string",
      "metadata": {},
      "usage": {
        "computedAt": "2026-07-26T12:00:00Z",
        "credits": {
          "limit": 1.1,
          "used": 1.1
        },
        "period": {
          "endsAt": "2026-07-26T12:00:00Z",
          "startedAt": "2026-07-26T12:00:00Z"
        },
        "runs": {
          "active": 1,
          "limit": 1
        },
        "spaces": {
          "limit": 1,
          "used": 1
        },
        "subaccountId": "V1StGXR8_Z5jdHi6B-myT"
      }
    }
  ],
  "nextCursor": "string"
}

List subaccounts using the simplified response envelope. Pass include=usage to inline current usage.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Query parameters

cursorstringOptional

limitintegerOptional<=200Defaults to 50

includelist of enumsOptional

Include optional subaccount expansions. Repeat the query parameter for multiple values.

Allowed values:

statusenumOptional

Filter subaccounts by lifecycle status.

Allowed values:

externalIdstringOptional1-200 characters

qstringOptional1-200 characters

Response

datalist of objects

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error

$	curl https://api.bctrl.ai/v1/subaccounts \
>	-H "Authorization: Bearer <token>"