Skip to content
Docs

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. The output shows which project or team the events are for.

terminal
# 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

Using the vercel activity command to view activity events.

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.

terminal
# 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, shorthand -s, shows events after a specific date. You can use ISO 8601 format or relative values like 1d, 7d, or 30d.

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

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

terminal
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.

terminal
vercel activity --project my-app

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

terminal
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.

terminal
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.

terminal
vercel activity --next 1706140800000

The --json option prints the events as JSON, which makes it easier to pipe to other tools like jq:

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

The JSON output also includes a scope object that shows which project or team the events are for. It has the teamSlug and, when the events are for one project, the projectName and projectIds:

terminal
vercel activity --json | jq '.scope'

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

terminal
vercel activity types
vercel activity types --json

List deployment events from the last week:

terminal
vercel activity --type deployment --since 7d

List all team events and output as JSON:

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

Paginate through results:

terminal
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:

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

Last updated March 17, 2026

Was this helpful?

supported.