---
title: "Get team usage metrics"
method: GET
path: "/api/reports/usage"
---

# Get team usage metrics

`GET /api/reports/usage`

Retrieves aggregated team usage metrics and individual member activity for a specified date range

## Query parameters

- `rangeDays` integer
- `endDate` string, date

## Response `200`

Successfully retrieved usage metrics

- object
  - `range` object, required — Date range for the usage report
    - `start` string, date, required — Start date of the reporting period
    - `end` string, date, required — End date of the reporting period
  - `aggregate` object, required — Aggregated team-level usage metrics
    - `teamName` string, required — Name of the team
    - `totalMembers` integer, required — Total number of team members (doest not include guests)
    - `activeMembers` integer, required — Number of members with activity (at least 1 fiew view) in the period
    - `inactiveMembers` integer, required — Number of members without activity (no file views) in the period
    - `totalFiles` integer, required — Total number of files owned by the team
    - `totalFilesCreated` integer, required — Number of files created during the period
    - `totalFilesViewed` integer, required — Number of unique files viewed during the period
    - `totalFileViews` integer, required — Total number of file view events during the period
    - `totalAiCreditsUsed` integer, required — Total AI credits consumed during the period
  - `members` object[], required — Individual member usage metrics
    - `email` string, email, required — Member's email address
    - `displayName` string, required — Member's display name
    - `filesCreated` integer, required — Number of files created by this member
    - `filesViewed` integer, required — Number of unique files viewed by this member
    - `fileViews` integer, required — Total file view events by this member
    - `aiCreditsUsed` integer, required — AI credits consumed by this member
    - `lastActive` string, date-time, required — Last time the user logged a file view event

## Other responses

- `400` — Invalid request parameters
- `401` — Missing or invalid bearer token
- `403` — Unauthorized - token is valid but lacks permission
- `500` — Internal server error
- `503` — Service temporarily unavailable

---

[API](https://skmtc.net/eraser/apis/render.md) · [All operations](https://skmtc.net/eraser/apis/render/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eraser/render/versions/c31350b435dc/schema)