---
title: Get User Activity Report
description: Retrieves aggregated user activity data for team members, including chat counts, message counts, and activity timestamps. Shows the same data as displayed in the Usage settings for Enterprise teams. Only available for Enterprise teams with OWNER or BILLING role.
product: Platform API
type: reference
prerequisites:
  - /docs/api/platform/quickstart
---

# Get User Activity Report



<EndpointDisplay method="get" path="/reports/user-activity" />

## Usage [#usage]

<CustomCodeBlock languages="['TypeScript', 'cURL']" defaultLanguage="TypeScript">
  <CodeVariant
    language="TypeScript"
    title="TypeScript Example"
    code="`import { v0 } from 'v0-sdk'

const result = await v0.reports.getUserActivity()

console.log(result)`"
  />

  <CodeVariant
    language="cURL"
    title="cURL Example"
    code="`curl -X GET https://api.v0.dev/v1/reports/user-activity \
  -H &#x22;Authorization: Bearer $V0_API_KEY&#x22; \
  -H &#x22;Content-Type: application/json&#x22;`"
  />
</CustomCodeBlock>

## API Signature [#api-signature]

### Request [#request]

#### Query Parameters [#query-parameters]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;startDate&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;Start date for the activity period in ISO 8601 format. If not provided, defaults to the beginning of available data.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;endDate&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;End date for the activity period in ISO 8601 format. If not provided, defaults to the current date.&#x22;,
    &#x22;deprecated&#x22;: false
  }
]"
/>

### Response [#response]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;object&#x22;,
    &#x22;type&#x22;: &#x22;'list'&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;data&#x22;,
    &#x22;type&#x22;: &#x22;object[]&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;Array of user activity records&#x22;,
    &#x22;deprecated&#x22;: false,
    &#x22;arrayItems&#x22;: {
      &#x22;name&#x22;: &#x22;item&#x22;,
      &#x22;type&#x22;: &#x22;object&#x22;,
      &#x22;required&#x22;: true,
      &#x22;description&#x22;: &#x22;User activity record&#x22;,
      &#x22;deprecated&#x22;: false,
      &#x22;properties&#x22;: [
        {
          &#x22;name&#x22;: &#x22;id&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;User ID&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;object&#x22;,
          &#x22;type&#x22;: &#x22;'user_activity'&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;user&#x22;,
          &#x22;type&#x22;: &#x22;object&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;User information&#x22;,
          &#x22;deprecated&#x22;: false,
          &#x22;properties&#x22;: [
            {
              &#x22;name&#x22;: &#x22;id&#x22;,
              &#x22;type&#x22;: &#x22;string&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;User ID&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;object&#x22;,
              &#x22;type&#x22;: &#x22;'user'&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;name&#x22;,
              &#x22;type&#x22;: &#x22;string&#x22;,
              &#x22;required&#x22;: false,
              &#x22;description&#x22;: &#x22;User's display name&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;email&#x22;,
              &#x22;type&#x22;: &#x22;string&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;User's email address&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;avatar&#x22;,
              &#x22;type&#x22;: &#x22;string&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;URL to user's avatar image&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;createdAt&#x22;,
              &#x22;type&#x22;: &#x22;string&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;ISO 8601 timestamp of when the user was created&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;updatedAt&#x22;,
              &#x22;type&#x22;: &#x22;string&#x22;,
              &#x22;required&#x22;: false,
              &#x22;description&#x22;: &#x22;ISO 8601 timestamp of when the user was last updated&#x22;,
              &#x22;deprecated&#x22;: false
            },
            {
              &#x22;name&#x22;: &#x22;teamV0Role&#x22;,
              &#x22;type&#x22;: &#x22;'V0Builder' | 'V0Chatter' | 'V0Viewer' | null&#x22;,
              &#x22;required&#x22;: true,
              &#x22;description&#x22;: &#x22;The user's v0 role, or null if no role is assigned&#x22;,
              &#x22;deprecated&#x22;: false
            }
          ]
        },
        {
          &#x22;name&#x22;: &#x22;chatCount&#x22;,
          &#x22;type&#x22;: &#x22;number&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Total number of chats created by the user&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;messageCount&#x22;,
          &#x22;type&#x22;: &#x22;number&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Total number of messages sent by the user&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;activeDays&#x22;,
          &#x22;type&#x22;: &#x22;number&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Number of distinct days the user was active&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;firstActivity&#x22;,
          &#x22;type&#x22;: &#x22;string | null&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;ISO 8601 timestamp of the user's first activity, or null if no activity&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;lastActivity&#x22;,
          &#x22;type&#x22;: &#x22;string | null&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;ISO 8601 timestamp of the user's last activity, or null if no activity&#x22;,
          &#x22;deprecated&#x22;: false
        }
      ]
    }
  },
  {
    &#x22;name&#x22;: &#x22;meta&#x22;,
    &#x22;type&#x22;: &#x22;object&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;Metadata about the response&#x22;,
    &#x22;deprecated&#x22;: false,
    &#x22;properties&#x22;: [
      {
        &#x22;name&#x22;: &#x22;totalCount&#x22;,
        &#x22;type&#x22;: &#x22;number&#x22;,
        &#x22;required&#x22;: true,
        &#x22;description&#x22;: &#x22;Total number of users in the response&#x22;,
        &#x22;deprecated&#x22;: false
      },
      {
        &#x22;name&#x22;: &#x22;dateRange&#x22;,
        &#x22;type&#x22;: &#x22;object&#x22;,
        &#x22;required&#x22;: true,
        &#x22;description&#x22;: &#x22;The date range of the query&#x22;,
        &#x22;deprecated&#x22;: false,
        &#x22;properties&#x22;: [
          {
            &#x22;name&#x22;: &#x22;start&#x22;,
            &#x22;type&#x22;: &#x22;string | null&#x22;,
            &#x22;required&#x22;: true,
            &#x22;description&#x22;: &#x22;ISO 8601 start date, or null if not specified&#x22;,
            &#x22;deprecated&#x22;: false
          },
          {
            &#x22;name&#x22;: &#x22;end&#x22;,
            &#x22;type&#x22;: &#x22;string | null&#x22;,
            &#x22;required&#x22;: true,
            &#x22;description&#x22;: &#x22;ISO 8601 end date, or null if not specified&#x22;,
            &#x22;deprecated&#x22;: false
          }
        ]
      }
    ]
  }
]"
/>

## Authorization [#authorization]

This endpoint is only available for:

* **Enterprise teams** (`v0-enterprise` plan)
* Users with **OWNER** or **BILLING** role on the team

## Behavior [#behavior]

* Returns all team members who have v0 access, including those with zero activity
* The date range cannot exceed 365 days
* Start date must not be after end date
* All timestamps are in ISO 8601 format

## Notes [#notes]

This endpoint shows the same data as displayed in the Usage settings for Enterprise teams. It provides a comprehensive view of team member activity, making it useful for team administrators to monitor engagement and usage patterns.