You can monitor usage and costs in the Neon Console or programmatically with the Neon API. For what each metric means and how it maps to your invoice, see Usage metrics and Invoice metrics on the Plans page.

View usage in the Neon Console

Neon exposes usage in three places in the Console: the Billing page (account-level charges and plan summary), the Projects page (org-level usage metrics), and the Project dashboard (project-level usage metrics when you are inside a project).

Billing page

From the Billing page (Organization → Billing in the Neon Console) you see account-level information: this month's summary including current plan, included features, usage-based pricing, and charges to date. Invoice line items appear only when there is a charge for that metric.

To open the Billing page:

  1. Navigate to the Neon Console.
  2. Select your organization from the breadcrumb menu at the top-left.
  3. Select Billing.

Projects page

From the Projects page (Organization → Projects) you see an org-level summary of four metrics across all projects: Compute, Storage, History, and Network transfer.

Project dashboard

When you open a project, the Project dashboard (Project → Dashboard) shows the same four metrics for that project only: Compute, Storage, History, and Network transfer.

Usage is shown since the start of the current billing period. Metrics may be delayed by about an hour and are not updated for inactive projects.

note

Network transfer metrics only appear on the Billing page when your usage exceeds the included allowance for your plan. To track network transfer before it results in charges, check the account usage panel on the Projects page, which always displays current usage. You can also monitor programmatically with the Consumption API. For more on network transfer, see Network transfer.

Billing metrics for pre-2025 custom contract customers

If you signed a contract with Neon prior to 01/01/2025, different billing metrics apply:

  • Storage is measured in GiBs instead of GB-month, and if you exceed your contract's monthly storage allowance, extra storage units are automatically allocated and billed. Extra storage charges are applied based on the number of additional storage units needed to cover peak storage usage during the current billing period, prorated from the date the extra storage was allocated. Peak usage resets at the beginning of the next billing period.
  • Written data is the total volume of data written from compute to storage during the monthly billing period, measured in gibibytes (GiB).

If you have questions or want to change the billing metrics defined in your contract, contact your Neon sales representative.

Retrieve usage with the API

On usage-based plans (Launch, Scale, Agent, and Enterprise), use the project consumption metrics API. It returns metrics that align with usage-based billing and match your invoice.

See Querying consumption metrics for the endpoint, required and optional parameters, example requests and responses, pagination, polling behavior, and building usage dashboards. For a guide to converting the raw API values into billing units and calculating your costs, see Usage and cost calculations.

Optimize your costs

For strategies to reduce your Neon costs across compute, storage, branches, and data transfer, see Cost optimization.