# GET /v1/sessions/{session_id}/events/summary - one-shot debug summary

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

GET

/v1/sessions/{session\_id}/events/summary

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/sessions/example/events/summary';
const options = {method: 'GET'};


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

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/sessions/example/events/summary
```

* Production APIapp.everruns.com/api/v1/sessions/{session\_id}/events/summary

## Parameters

### Path Parameters

**session\_id**

required

string

Session ID (prefixed, e.g., sess\_…)

## Responses

### 200

Per-type counts and time span for the session

Media typeapplication/json

Aggregate result of the events summary query — total count, per-type breakdown, and a few convenience rollups (turn count, failure count).

object

**by\_type**

required

Per-type count, sorted by event\_type asc.

Array\<object>

One row of `EventsSummaryResult.by_type` — the per-event-type count produced by the events summary query.

object

**count**

required

Count of items matching the query.

integer format: int64

**event\_type**

required

Event-type discriminator (e.g. `turn.started`, `tool.completed`).

string

**error\_count**

required

Convenience: count of failure-shaped event types (`turn.failed`, `tool.failed`, `*.error`, `subagent.failed`).

integer format: int64

**first\_ts**

Earliest event timestamp, if any.

string | null format: date-time

**last\_ts**

Latest event timestamp, if any.

string | null format: date-time

**total**

required

Total event count across all types.

integer format: int64

**turn\_count**

required

Convenience: count of `turn.started` events.

integer format: int64

##### Examplegenerated

```json
{
  "by_type": [
    {
      "count": 1,
      "event_type": "example"
    }
  ],
  "error_count": 1,
  "first_ts": "2026-04-15T12:00:00Z",
  "last_ts": "2026-04-15T12:00:00Z",
  "total": 1,
  "turn_count": 1
}
```

### 400

Invalid session ID

### 404

Session not found

### 500

Internal server error