# List organization session actors

Source: <https://everruns.com/docs/api/operations/list_monitoring_actors/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/List organization session actors

# List organization session actors

Preview

Operate durable execution, schedules, sandbox infrastructure, budgets, payments and audit logs.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/monitoring/actors`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Query Parameters

**offset**

integer format: int32

Zero-based offset for fixed 200-actor pages; maximum 1000000.

#### Example

```json
0
```

**worker_id**

string

Filter by a valid current lease holder, up to 256 UTF-8 bytes.

#### Example

```plaintext
worker-01
```

**phase**

string

Filter by runnable, model, tools, waiting, or setup execution state.

#### Example

```plaintext
model
```

## Responses

200Organization actor page

### 200

Organization actor page

Media typeapplication/json

Bounded page of current session actor observations.

object

**actors**

required

Up to 200 matching actors, ordered by expired leases and oldest runnable work.

Array\<object>

Session actor ownership, lease validity, and durable progress cursors.

object

**attempts_since_release**

Lease attempts accumulated since the last release.

integer | null format: int32

**cancel_requested_at**

UTC cancellation request timestamp; null when cancellation is not requested.

string | null format: date-time

**consumed_seq**

Persisted consumed event cursor; its difference from inbox_seq is not a pending-message count.

integer | null format: int64

**fence**

Monotonic ownership fence; null when no actor row exists.

integer | null format: int64

**holder**

Current recorded holder, or previous holder for an expired lease; null when unleased.

string | null

**inbox_seq**

Durable inbox progress cursor; it is not a message count.

integer | null format: int64

**lease_expires_at**

UTC deadline of the recorded lease; null when unleased.

string | null format: date-time

**lease_renewed_at**

Last persisted acquisition or renewal acknowledgement in UTC; null before an acknowledgement or after release.

string | null format: date-time

**lease_state**

required

Observed lease validity: held, expired, or unleased.

string

**lease_ttl_ms**

Positive interval between renewal acknowledgement and expiry in milliseconds; null when unavailable.

integer | null format: int64

**next_input_seq**

Persisted next-input progress cursor.

integer | null format: int64

**org_id**

required

Public identifier of the owning session’s organization.

string

**phase**

required

Observed execution state; idle is also possible for a released actor detail.

string

**phase_since**

required

UTC timestamp of the committed observation used to classify the phase.

string format: date-time

**runnable_age_ms**

Milliseconds awaiting a valid lease; null for held or parked actors.

integer | null format: int64

**runnable_since**

UTC timestamp when the actor became runnable; null for parked work.

string | null format: date-time

**session_id**

required

Canonical session identifier whose actor is being inspected.

string

**session_status**

required

Persisted session lifecycle status.

string

**generated_at**

required

UTC observation time for this actor page.

string format: date-time

**next_offset**

Offset for the next page; null when there are no further matching actors.

integer | null format: int32

### Example

```json
{
  "actors": [
    {
      "attempts_since_release": 1,
      "cancel_requested_at": "2026-10-14T12:00:02Z",
      "consumed_seq": 39,
      "fence": 17,
      "holder": "worker-01",
      "inbox_seq": 42,
      "lease_expires_at": "2026-10-14T12:00:10Z",
      "lease_renewed_at": "2026-10-14T12:00:00Z",
      "lease_state": "held",
      "lease_ttl_ms": 10000,
      "next_input_seq": 12,
      "org_id": "org_00000000000000000000000000000001",
      "phase": "model",
      "phase_since": "2026-10-14T12:00:01Z",
      "runnable_age_ms": 3000,
      "runnable_since": "2026-10-14T11:59:59Z",
      "session_id": "session_01933b5a000070008000000000000001",
      "session_status": "active"
    }
  ],
  "generated_at": "2026-10-14T12:00:03Z",
  "next_offset": 200
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/monitoring/actors?offset=0&worker_id=worker-01&phase=model';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url 'https://app.everruns.com/api/v1/monitoring/actors?offset=0&worker_id=worker-01&phase=model'
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Organization actor page

```json
{
  "actors": [
    {
      "attempts_since_release": 1,
      "cancel_requested_at": "2026-10-14T12:00:02Z",
      "consumed_seq": 39,
      "fence": 17,
      "holder": "worker-01",
      "inbox_seq": 42,
      "lease_expires_at": "2026-10-14T12:00:10Z",
      "lease_renewed_at": "2026-10-14T12:00:00Z",
      "lease_state": "held",
      "lease_ttl_ms": 10000,
      "next_input_seq": 12,
      "org_id": "org_00000000000000000000000000000001",
      "phase": "model",
      "phase_since": "2026-10-14T12:00:01Z",
      "runnable_age_ms": 3000,
      "runnable_since": "2026-10-14T11:59:59Z",
      "session_id": "session_01933b5a000070008000000000000001",
      "session_status": "active"
    }
  ],
  "generated_at": "2026-10-14T12:00:03Z",
  "next_offset": 200
}
```

## Matching endpoints