List a browserâ€™s Runs

GET

/v1/browsers/:browserId/runs

GET

/v1/browsers/:browserId/runs

curl https://api.bctrl.ai/v1/browsers/browserId/runs \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "connections": {
        "cdpUrl": "string",
        "expiresAt": "2026-07-26T12:00:00Z",
        "liveViewReadOnlyUrl": "string",
        "liveViewUrl": "string",
        "webdriverUrl": "string"
      },
      "control": {
        "holder": "agent",
        "since": "2026-07-26T12:00:00Z"
      },
      "createdAt": "2026-07-26T12:00:00Z",
      "endedAt": "2026-07-26T12:00:00Z",
      "endReason": "string",
      "id": "run_uAAAAAAAAAAAAAAAAAAAAAA",
      "location": "us-east",
      "object": "string",
      "recording": {
        "enabled": true
      },
      "resourceId": "br_uAAAAAAAAAAAAAAAAAAAAAA",
      "resourceType": "string",
      "spaceId": "sp_uAAAAAAAAAAAAAAAAAAAAAA",
      "startedAt": "2026-07-26T12:00:00Z",
      "status": "starting",
      "taskId": "task_uAAAAAAAAAAAAAAAAAAAAAA",
      "traceId": "string",
      "updatedAt": "2026-07-26T12:00:00Z",
      "machineAccess": {
        "count": 1,
        "firstAt": "2026-07-26T12:00:00Z",
        "inheritedFrom": "run_uAAAAAAAAAAAAAAAAAAAAAA",
        "used": true
      },
      "usage": {
        "aiTokensTotal": 1,
        "billingStatus": "pending",
        "captchaSolves": 1,
        "computedAt": "2026-07-26T12:00:00Z",
        "cpuSeconds": 1.1,
        "creditsUsed": 1.1,
        "filesBytes": 1,
        "memoryGbSeconds": 1.1,
        "proxyBytes": 1,
        "runtimeSeconds": 1.1
      },
      "warnings": [
        {
          "message": "string",
          "type": "string",
          "browserIds": [
            "br_uAAAAAAAAAAAAAAAAAAAAAA"
          ]
        }
      ]
    }
  ],
  "hasMore": false,
  "nextCursor": "string"
}

List the retained Runs belonging to this browser, including ended and failed Runs, using cursor pagination.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

browserIdstringRequired

Query parameters

cursorstringOptional

orderenumOptional

Order by createdAt and ID. Defaults to desc.

Allowed values:

limitintegerOptional<=200Defaults to 50

spaceIdstring or "default"Optional

statusanyOptional

fromdatetimeOptional

RFC 3339 timestamp with a UTC offset.

todatetimeOptional

RFC 3339 timestamp with a UTC offset.

include"usage"Optional

Response headers

BCTRL-Request-IdstringOptional

Current request identifier, also echoed in errors.

BCTRL-VersionstringOptional

Negotiated dated API version.

RateLimit-Limitinteger

Evaluated policy limit; zero when no finite policy was evaluated.

RateLimit-Remaininginteger

Remaining policy budget; zero when no finite policy was evaluated.

RateLimit-Resetinteger

Seconds until reset; zero when no finite policy was evaluated.

Response

datalist of objects

hasMorebooleanDefaults to false

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error