vercel usage
The vercel usage command displays billing usage for the current billing period or a custom date range. It shows Managed Infrastructure Units (MIUs) and costs for each service, helping you understand your resource consumption.
vercel usageUsing the vercel usage command to view billing usage
for the current billing period.
vercel usage --from 2025-01-01 --to 2025-01-31Using the vercel usage command to view billing usage
for a custom date range.
The command outputs a table showing:
- Service: The name of each Vercel service
- Usage (MIUs): Managed Infrastructure Units consumed
- 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-31Using the vercel usage command with a custom start
date.
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-31Using the vercel usage command with a custom end
date.
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 dailyUsing the vercel usage command to show daily usage
breakdown.
vercel usage --from 2025-01-01 --to 2025-01-31 --breakdown weeklyCombining --breakdown with a custom date range.
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 --format option, shorthand -F, specifies the output format. Currently, json is the only supported format option.
vercel usage --format jsonUsing the vercel usage command to output usage data
as JSON.
The JSON output includes:
period: The start and end dates of the querycontext: The user or team contextservices: An array of services with usage and cost detailstotals: Aggregated totals for all serviceschargeCount: 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:
For more information on global options and their usage, refer to the options section.
Was this helpful?