Get a run | BCTRL Docs

{
  "counts": {
    "events": 1,
    "files": 1,
    "spans": 1
  },
  "createdAt": "2026-07-26T12:00:00Z",
  "durationSeconds": 1.1,
  "failure": {
    "code": "string",
    "message": "string"
  },
  "finishedAt": "2026-07-26T12:00:00Z",
  "id": "run_AAAAAAAAAAAAAAAAAAAAAA",
  "recording": {
    "enabled": true
  },
  "runtimeId": "rt_AAAAAAAAAAAAAAAAAAAAAA",
  "runtimeType": "browser",
  "spaceId": "sp_AAAAAAAAAAAAAAAAAAAAAA",
  "startedAt": "2026-07-26T12:00:00Z",
  "status": "active",
  "connection": {
    "cdpUrl": "string",
    "expiresAt": "2024-01-15T09:30:00Z",
    "recording": {
      "enabled": true
    },
    "runId": "run_AAAAAAAAAAAAAAAAAAAAAA",
    "webDriverUrl": "string",
    "webMcpUrl": "string"
  },
  "usage": {
    "aiTokensTotal": 1,
    "billingStatus": "pending",
    "captchaSolves": 1,
    "computedAt": "2026-07-26T12:00:00Z",
    "creditsUsed": 1.1,
    "filesBytes": 1,
    "proxyBytes": 1,
    "runtimeSeconds": 1.1
  }
}

Get one run using the simplified run resource.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runIdstringRequired

Unique run identifier generated by BCTRL.

Query parameters

include"connection"Optional

Response

countsobject

createdAtdatetime

RFC 3339 timestamp with a UTC offset.

durationSecondsdouble or null>=0

failureobject or null

finishedAtdatetime or null

RFC 3339 timestamp with a UTC offset.

idstring

Unique run identifier generated by BCTRL.

recordingobject

runtimeIdstring

Unique runtime identifier generated by BCTRL.

runtimeTypeenum

spaceIdstring

Unique space identifier generated by BCTRL.

startedAtdatetime

RFC 3339 timestamp with a UTC offset.

statusenum

connectionobjectOptional

usageobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

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

Authentication

Path parameters

Headers

Query parameters

Response

Errors