The vercel usage command displays billing usage for the current billing period or a custom date range. It shows usage and costs for each service, helping you understand your resource consumption.

This is only available for Owner, Member, Developer, Security, Billing, and Enterprise Viewer roles for the current active team.

vercel usage

vercel usage --from 2025-01-01 --to 2025-01-31

The command outputs a table showing:

• Service: The name of each Vercel service
• Usage: Resources consumed (USD or legacy MIUs)
• Effective Cost: The cost after any applicable discounts
• Billed Cost: The final amount charged

These are options that only apply to the vercel usage command.

The --from option specifies the start date for the usage query. The date is interpreted as midnight in Los Angeles (Pacific) time.

vercel usage --from 2025-01-01 --to 2025-01-31

When using --from, you must also specify --to.

The --to option specifies the end date for the usage query. The date is interpreted as end of day (23:59:59) in Los Angeles (Pacific) time.

vercel usage --from 2025-01-01 --to 2025-01-31

When using --to, you must also specify --from.

The --breakdown option shows usage grouped by time period instead of aggregated totals. Valid values are daily, weekly, or monthly.

vercel usage --breakdown daily

vercel usage --from 2025-01-01 --to 2025-01-31 --breakdown weekly

When using the breakdown mode, the output shows:

• Usage grouped by the specified period (day, week, or month)
• Per-service details for each period
• A grand total at the end

The data supports 1-day granularity with a maximum date range of 1 year.

The --format option, shorthand -F, specifies the output format. Currently, json is the only supported format option.

vercel usage --format json

The JSON output includes:

• period: The start and end dates of the query
• context: The user or team context
• services: An array of services with usage and cost details
• totals: Aggregated totals for all services
• chargeCount: The number of individual charges processed

When using --breakdown, the JSON output includes a breakdown array containing usage data for each period, plus a grandTotal object with aggregated totals.

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

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --non-interactive
• --scope
• --team
• --token
• --version

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