• Documentation
  • Pricing
© 2026 Serverless, Inc. All rights reserved.

Framework

  • Overview
  • Documentation
  • Plugins360
  • Pricing

Learn

  • Blog
  • GuidesUpdated
  • Examples240
  • Courses

Resources

  • Support
  • Security
  • Trust Center
  • Status

Community

  • Slack
  • GitHub47k
  • Forum
  • Meetups

Company

  • About
  • Careers
  • Contact
  • Partners

Legal

  • Terms of Service
  • Privacy Policy
  • Trademark
  • DMCA
Serverless Framework Logo

Serverless Framework

Intro
SetupUpgrading To V4ConceptsTutorialAWS CredentialsLicense Keys
DeployingPackagingBuildingTestingServicesFunctions
OverviewHTTP (API Gateway v2)REST (API Gateway v1)ActiveMQApplication Load BalancerAlexa SkillAlexa Smart HomeCloudWatch EventCloudWatch LogCloudFrontCognito User PoolEventBridge EventIoTIoT Fleet ProvisioningKafkaKinesis & DynamoDBMSKRabbitMQS3ScheduleSNSSQSWebsocket
LayersManaged InstancesAlertsVersion PruningDomainsIAM Function PermissionsParameters
OverviewSelf-reference serverless.ymlServerless CoreEnvironment VariablesCLI OptionsExternal YAML/JSON FilesJavascript propertiesGitDoppler
OverviewS3 ObjectsSSM Parameter Store & Secrets ManagerCloudFormation Stack Outputs
OverviewVaultTerraform State Output
ResourcesComposing ServicesDeployment BucketStatePython support
OverviewRuntimeGatewayMemoryBrowserCode InterpreterDev Mode
API Gateway Proxy
OverviewGeneral ConfigurationAuthenticationAPI KeysData SourcesResolversPipeline FunctionsCachingDelta SyncCustom DomainWAFCLI Commands
Deploying SAM/CFN TemplatesWorkflow Tips
OverviewCreating PluginsCLI OutputCustom CommandsCustom VariablesExtending the Configuration schemaExtending and overriding configuration
OverviewDashboardAxiom
Overviewdeploydeploy functiondeploy listdevdiffinfoinvokeinvoke localloginlogin awslogin aws ssologsmetricspackageplugin installplugin uninstallprintprunereconcileremoverollbackrollback functionsupportusage
Overview
OverviewMetricsTracesTroubleshoot
OverviewNode.jsPython
OutputsProviders
OverviewBranch DeploymentsPreview DeploymentsCustom ScriptsTestingPrivate PackagesNotificationsMono ReposDeploy in your own CI/CDBest PracticesTroubleshootingFAQ
OverviewSetupToolsAWS Integration
Serverless.yml Reference
Examples and TutorialsConfiguration Validation
  1. CLI Reference
  2. Usage

Usage

The usage command displays your org's instance credit usage for the current month. It also exports a list of billable instances that consumed those credits to an instances.csv file in the current directory.

serverless usage

Options

  • --org The org name to show usage for. Defaults to your service org if found, or your default personal org.

The list of instances in the instances.csv file has 4 columns:

  • ID: This is the instance ID. It is the CloudFormation stack ID if the instance was deployed by the Serverless Framework v4. If the instance is only managed by the Serverless Dashboard, the dashboard instance ID is used, which is a combination of the service, region and stage names.
  • Age: This is the number of days the instance has been active. If it is below 10 days, you can still remove the instance before the end of the month so that you are not billed for it. However, if the instance is older than 10 days and you remove it, you will be billed for it this month, but not the following months.
  • Type: This shows the type of instance. It is either a CLI instance deployed by the Serverless Framework v4, Dashboard-managed instance, or both.
  • User: This shows either the user or the license key used to deploy the instance. For exmaple, user:user-name or license:license-label. It may be blank if this data is not available.

Example

my-service $ serverless usage

The serverlessinc org used 18 Instance Credits this month.

A list of billable instances has been saved to instances.csv in the current directory.

If you have any questions about your usage, please contact support@serverless.com.

my-service $
Edit this page
Prev supportNextOverview

Contents

  • Usage
  • Options
  • Example

Related

GuidesPluginsExamplesSlack CommunitySupport