# Show a session's whole run

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Sessions & workspaces](https://everruns.com/docs/api/groups/sessions-workspaces/)/Show a session's whole run

# Show a session's whole run

Preview

Show the run a session belongs to: the first session and every agent session started under it, with status, turns and spend.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/sessions/{session_id}/run`

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

## Parameters

### Path Parameters

**session_id**

required

string

Prefixed public identifier

## Responses

200Success

### 200

Success

Media typeapplication/json

The run a session belongs to: every agent that took part, with status, timing and spend.

object

**cost_usd**

required

Spend of every session in the run, in USD.

number format: double

**first_session_cost_usd**

required

Spend of the first session alone, in USD.

number format: double

**root_session_id**

required

The run’s first session, the one the person talks to.

string

**sessions**

required

The first session, then every session started under it by creation.

Array\<object>

One agent session of the run.

object

**agent**

One of:

* object

  The agent that ran it. Absent when it has none or it was deleted.

  object

  **id**

  required

  The agent’s id, as `/v1/agents/{agent_id}` takes it.

  string

  **name**

  required

  The agent’s display name.

  string

* null

  null

**cost_usd**

required

Model spend in USD.

number format: double

**created_at**

required

string format: date-time

**last_turn_at**

When its last turn ended; absent while it works or before it ran.

string | null format: date-time

**last_turn_status**

Outcome of its last finished turn: `completed`, `failed` or `cancelled`.

string | null

**parent_session_id**

The session that handed it work; absent for the first session.

string | null

**session_id**

required

Session’s prefixed public identifier.

string

**status**

required

Session status: `started`, `active`, `idle`, `waiting_for_tool_results`, …

string

**title**

The session’s title: for work handed off, the task’s name.

string | null

**turns**

required

Its turns, oldest first.

Array\<object>

One turn of a session in the run.

object

**cost_usd**

required

Model spend of the turn in USD.

number format: double

**ended_at**

Absent while the turn runs.

string | null format: date-time

**started_at**

required

string format: date-time

**status**

required

Trace status of the turn: `running`, `completed`, `failed`, …

string

**turn_id**

required

Public turn id (`turn_...`).

string

**turn_no**

required

Turn number within its session, from 1.

integer format: int32

**truncated**

required

More sessions or turns existed than were returned.

boolean

**waiting_requests**

required

Questions and approvals any agent in the run waits on the person for.

integer

### Example

```json
{
  "cost_usd": 5.06,
  "first_session_cost_usd": 0.25,
  "root_session_id": "session_01h9xk1a",
  "sessions": [
    {
      "agent": {
        "id": "agent_01h9xk2m",
        "name": "Triage"
      },
      "cost_usd": 0.21,
      "created_at": "2026-11-03T09:00:00Z",
      "last_turn_at": "2026-11-03T09:01:30Z",
      "last_turn_status": "completed",
      "parent_session_id": "session_01h9xk1a",
      "session_id": "session_01h9xk2m",
      "status": "idle",
      "title": "Triage the failing build",
      "turns": [
        {
          "cost_usd": 0.21,
          "ended_at": "2026-11-03T09:01:30Z",
          "started_at": "2026-11-03T09:00:00Z",
          "status": "completed",
          "turn_id": "turn_01h9xk2m",
          "turn_no": 1
        }
      ]
    }
  ],
  "truncated": false,
  "waiting_requests": 1
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/sessions/example/run';
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/sessions/example/run
```

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

200

200 · Success

```json
{
  "cost_usd": 5.06,
  "first_session_cost_usd": 0.25,
  "root_session_id": "session_01h9xk1a",
  "sessions": [
    {
      "cost_usd": 0.21,
      "created_at": "2026-11-03T09:00:00Z",
      "last_turn_at": "2026-11-03T09:01:30Z",
      "last_turn_status": "completed",
      "parent_session_id": "session_01h9xk1a",
      "session_id": "session_01h9xk2m",
      "status": "idle",
      "title": "Triage the failing build",
      "turns": []
    }
  ],
  "truncated": false,
  "waiting_requests": 1
}
```

## Matching endpoints