List runs | BCTRL Docs

List runs across visible runtime work using the simplified run resource.

AuthorizationBearer

Use Bearer <api-key>.

statuslist of enumsOptional

Filter by one or more run statuses. Repeat the query parameter for multiple values.

Allowed values:

spaceIdstringOptional

runtimeIdstringOptional

cursorstringOptional

limitintegerOptional<=200Defaults to 50

datalist of objects

nextCursorstring or null

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

1	{
2	"data": [
3	{
4	"createdAt": "2026-07-26T12:00:00Z",
5	"durationSeconds": 1.1,
6	"failure": {
7	"code": "string",
8	"message": "string"
9	},
10	"finishedAt": "2026-07-26T12:00:00Z",
11	"id": "run_AAAAAAAAAAAAAAAAAAAAAA",
12	"recording": {
13	"enabled": true
14	},
15	"runtimeId": "rt_AAAAAAAAAAAAAAAAAAAAAA",
16	"runtimeType": "browser",
17	"spaceId": "sp_AAAAAAAAAAAAAAAAAAAAAA",
18	"startedAt": "2026-07-26T12:00:00Z",
19	"status": "active"
20	}
21	],
22	"nextCursor": "string"
23	}

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