Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
105 lines (67 sloc) 2.34 KB

Heroku Billing

Version License

Generates a billing overview including dyno and add-on costs per application.

Supported Node versions: 8 or higher

Licensed under the MIT license, see LICENSE for more information.

Heroku Billing


This is a Heroku client plugin and requires the Heroku CLI to be installed.

Install heroku-billing as a plugin from npm:

heroku plugins:install @hyperoslo/heroku-billing



By default, the generated billing overview includes all applications.

heroku billing

Personal applications only:

heroku billing --personal

Team applications only:

heroku billing --team hyperoslo

A single application:

heroku billing -a hyper-rocks
heroku billing -r production

Filter applications matching given pattern:

heroku billing --pattern foobar

Inactive dynos & shared add-ons

Inactive dynos – fully scaled down processes – are not included in the overview by default as they generate a lot of clutter.

To include all inactive dynos, shown in gray:

heroku billing --include-inactive-dynos

Add-ons shared between applications are always shown in gray.


By default, the generated billing overview uses Heroku's human-readable table format.

Generate the billing overview in JSON format:

heroku billing --json

Generate the billing overview in CSV format:

heroku billing --csv


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create pull request


Hyper made this. We're a digital communications agency with a passion for good code, and if you're using this plugin we probably want to hire you.