vercel activity

The vercel activity command displays activity events for your linked project. You can filter events by type, date range, and project, or view all events across your team.

By default, running vercel activity shows events scoped to the linked project. Use --all to see all events across your team, or --project to target a specific project.

# List events for the linked project
vercel activity
 
# List all team events from the last 30 days
vercel activity --all --since 30d
 
# Filter by event type
vercel activity --type deployment --since 7d

These options only apply to the vercel activity command.

The --type option filters events by event type. You can repeat the flag or use comma-separated values. Run vercel activity types to see all available event types.

# Single type
vercel activity --type deployment
 
# Multiple types with repeated flags
vercel activity --type deployment --type project-created
 
# Comma-separated types
vercel activity --type deployment,project-created

The --since option shows events after a specific date. You can use ISO 8601 format or relative values like 1d, 7d, or 30d.

vercel activity --since 7d
vercel activity --since 2026-01-01T00:00:00Z

The --until option shows events before a specific date. Accepts the same formats as --since.

vercel activity --since 30d --until 7d

The --project option, shorthand -p, filters events by a specific project name or ID. This overrides the auto-detected linked project.

vercel activity --project my-app

The --all option, shorthand -a, shows all events across your team instead of scoping to the linked project.

vercel activity --all --since 30d

You can't use --all and --project together.

The --limit option specifies the maximum number of events to return. The default is 20, and the maximum is 100.

vercel activity --limit 50

The --next option paginates through results. After each page, the command prints the value to pass to --next for the following page.

vercel activity --next 1706140800000

The --format option controls the output format. Set it to json to output structured JSON, which makes it easier to pipe to other tools like jq.

vercel activity --format json | jq '.events[]'

Lists all available event types with descriptions. Use this to find valid values for the --type filter.

vercel activity types
vercel activity types --format json

List deployment events from the last week:

vercel activity --type deployment --since 7d

List all team events and output as JSON:

vercel activity --all --format json | jq '.events[] | {type, text: .text}'

Paginate through results:

vercel activity --limit 10
# Use the --next value from the output to get the next page
vercel activity --limit 10 --next 1706140800000

The following global options can be passed when using the vercel activity command:

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --scope
• --token

For more information on global options and their usage, refer to the options section.