---
title: "Get Usage Activity"
method: GET
path: "/usage/activity"
tags: ["Usage"]
---

# Get Usage Activity

`GET /usage/activity`

Returns chat and project activity for the active billing scope. Team owners and billing members receive team-wide activity by default; other team members receive their own activity.

## Query parameters

- `start` string, date-time — Inclusive ISO 8601 start timestamp. Defaults to seven days ago.
- `end` string, date-time — Exclusive ISO 8601 end timestamp. Defaults to the current time.
- `userId` string — Filter usage by user. Team owners and billing members may select any team member; other callers may select only themselves.

## Response `200`

Response for status 200

- UsageActivity
  - `object` 'usage_activity', required — Object type identifier.
  - `range` object, required — Time range covered by the response.
    - `start` string, date-time, required — Inclusive ISO 8601 start timestamp.
    - `end` string, date-time, required — Exclusive ISO 8601 end timestamp.
  - `scope` object, required — Authorized billing scope used for this response.
    - `id` string, required — Billing scope identifier.
    - `type` 'team' | 'personal', required — Billing scope type.
    - `isTeamWide` boolean, required — Whether the response includes usage for the entire team.
    - `userId` string — User attribution applied to the response, when filtered.
  - `summary` object, required
    - `activeUsers` integer, required — Distinct active users.
    - `activeDays` integer, required — Distinct active days.
    - `chatCount` integer, required — Distinct active chats.
    - `messageCount` integer, required — Assistant messages.
  - `projects` object[], required — Activity grouped by Vercel project or draft status.
    - `kind` 'project' | 'drafts' | 'unavailable', required — Project grouping type.
    - `vercelProjectId` string, nullable, required — Vercel project identifier, when available.
    - `name` string, required — Project grouping display name.
    - `chatCount` integer, required — Distinct active chats.
    - `messageCount` integer, required — Assistant messages.
    - `activeDays` integer, required — Distinct active days.
    - `firstActivity` string, date-time, required — First activity timestamp.
    - `lastActivity` string, date-time, required — Most recent activity timestamp.
  - `chats` object[], required — Activity grouped by chat.
    - `kind` 'chat' | 'unavailable', required — Chat availability type.
    - `chatId` string, required — Chat identifier.
    - `title` string, required — Chat title or availability label.
    - `vercelProjectId` string, nullable, required — Associated Vercel project identifier.
    - `projectName` string, nullable, required — Associated project name.
    - `messageCount` integer, required — Assistant messages.
    - `activeDays` integer, required — Distinct active days.
    - `firstActivity` string, date-time, required — First activity timestamp.
    - `lastActivity` string, date-time, required — Most recent activity timestamp.

## Other responses

- `401` — Response for status 401
- `403` — Response for status 403
- `422` — Response for status 422
- `429` — Response for status 429
- `500` — Response for status 500

---

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