---
title: "Get User Activity Report"
method: GET
path: "/reports/user-activity"
tags: ["reports"]
---

# Get User Activity Report

`GET /reports/user-activity`

Retrieves aggregated user activity data for team members, including chat counts, message counts, and activity timestamps. Only available for Enterprise teams with OWNER or BILLING role. Shows the same data as displayed in the Usage settings for Enterprise teams.

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` object[], required
    - `id` string, required
    - `object` 'user_activity', required
    - `user` object, required
      - `id` string, required — A unique identifier for the user.
      - `object` 'user', required — Fixed value identifying this object as a user.
      - `name` string — Optional full name of the user.
      - `email` string, required — The user's email address.
      - `avatar` string, required — URL to the user's avatar image.
      - `createdAt` string, date-time, required — The ISO timestamp representing when the user was created.
      - `updatedAt` string, date-time — The ISO timestamp of the last update to the user.
      - `teamV0Role` 'V0Builder' | 'V0Chatter' | 'V0Viewer', nullable, required — The user's v0 role
    - `chatCount` number, required — Total number of chats created by the user
    - `messageCount` number, required — Total number of messages sent by the user
    - `activeDays` number, required — Number of distinct days the user was active
    - `firstActivity` string, date-time, nullable, required — Timestamp of the user's first activity
    - `lastActivity` string, date-time, nullable, required — Timestamp of the user's last activity
  - `meta` object, required
    - `totalCount` number, required
    - `dateRange` object, required
      - `start` string, date-time, nullable, required
      - `end` string, date-time, nullable, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2026-03-06** `79811cd54faa` — 1 info
  - endpoint added
- **2025-08-24** `3521652a43a7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/reports/user-activity/get.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/79811cd54faa/schema)
