# Summarize a session's trace: turn, step and error totals, a minimap of turn buckets, and the turns that failed.

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

GET

/v1/sessions/{session\_id}/trace

Select code samplecURL (shell:curl)

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

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

## Parameters

### Path Parameters

**session\_id**

required

string

Prefixed public identifier

### Query Parameters

**buckets**

integer format: int32

Minimap buckets wanted, 1 to 500. Defaults to 120.

## Responses

### 200

Success

Media typeapplication/json

Session-wide trace summary and minimap.

object

**bucket\_size**

required

Turns per minimap bucket.

integer format: int32

**buckets**

required

Minimap buckets in turn order.

Array\<object>

A range of turns on the minimap.

object

**duration\_ms**

required

Summed turn durations.

integer format: int64

**errors**

required

Failed steps and turns in the bucket.

integer format: int64

**from\_turn**

required

First turn in the bucket.

integer format: int32

**steps**

required

Steps across the bucket’s turns.

integer format: int64

**to\_turn**

required

Last turn in the bucket.

integer format: int32

**error\_count**

required

Steps and turns that failed, across the session.

integer format: int64

**error\_turns**

required

Turns with errors, newest first, at most 500.

Array\<integer>

**first\_started\_at**

Start of the first turn.

string | null format: date-time

**input\_tokens**

required

Prompt tokens across all model calls.

integer format: int64

**last\_activity\_at**

Latest start or end of any turn.

string | null format: date-time

**output\_tokens**

required

Completion tokens across all model calls.

integer format: int64

**step\_count**

required

Steps across all turns.

integer format: int64

**turn\_count**

required

Turns in the session.

integer format: int64

##### Example

```json
{
  "bucket_size": 10,
  "buckets": [
    {
      "duration_ms": 421000,
      "errors": 2,
      "from_turn": 1,
      "steps": 142,
      "to_turn": 10
    }
  ],
  "error_count": 27,
  "input_tokens": 4812330,
  "output_tokens": 91204,
  "step_count": 18311,
  "turn_count": 1240
}
```