---
title: "Fetch session aggregates for a specific data app"
method: GET
path: "/v1/dataapps/apps/{id}/sessions/summary"
tags: ["Data Apps"]
---

# Fetch session aggregates for a specific data app

`GET /v1/dataapps/apps/{id}/sessions/summary`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/dataapps/apps/{id}/sessions/summary`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

Returns aggregate statistics derived purely from the database (total session count, unique users, average duration, sessions today). No user-org service calls are made, so this response is safe to cache on the client or a CDN.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- SessionAggregates
  - `count` integer, required: Total number of sessions for this data app
  - `uniqueUsers` integer, required: Number of unique users who have started a session for this data app
  - `avgDurationMs` number, double, nullable, required: Average session duration in milliseconds. Null if no completed sessions exist
  - `sessionsToday` integer, required: Number of sessions started today for this data app

## Other responses

- `400`: Bad Request
- `404`: Data app not found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/tetrascience/apis/data-ai-workspace-api.md) - [All operations](https://skmtc.dev/tetrascience/apis/data-ai-workspace-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/data-ai-workspace-api/revisions/99f3b2ac0b83?raw)