vercel list
The command, which can be shortened to , provides a list of recent deployments for the currently-linked Vercel Project.
Using the vercel list command to retrieve information
about multiple deployments for the currently-linked Vercel Project.
Using the vercel list command to retrieve information
about deployments for a specific Vercel Project.
Using the vercel list command to retrieve information
about deployments filtered by status.
Using the vercel list command to retrieve information
about deployments filtered by metadata.
Using the vercel list command to retrieve information
about deployments including retention policy.
These are options that only apply to the command.
The option, shorthand , can be used to filter results based on Vercel deployment metadata.
Using the vercel list command with the
--meta option.
To see the meta values for a deployment, use GET /deployments/{idOrUrl} .
The option, shorthand , can be used to display expiration based on Vercel project deployment retention policy.
Using the vercel list command with the
--policy option.
The option can be used to skip questions you are asked when setting up a new Vercel Project. The questions will be answered with the default scope and current directory for the Vercel Project name and location.
Using the vercel list command with the
--yes option.
The option, shorthand , can be used to filter deployments by their status.
Using the vercel list command with the
--status option to filter by a single status.
You can filter by multiple status values using comma-separated values:
Using the vercel list command to filter by multiple
status values.
The supported status values are:
- - Deployments currently being built
- - Deployments that failed during build or runtime
- - Deployments in the initialization phase
- - Deployments waiting to be built
- - Successfully deployed and available
- - Deployments that were canceled before completion
Use the option to list the deployments for a specific environment. This could be production, preview, or a custom environment.
The following global options can be passed when using the vercel list command:
For more information on global options and their usage, refer to the options section.
Was this helpful?