# Financial report

URL: https://docs.vaultpanel.net/guides/hosting-and-billing/financial-report

> See what your hosting accounts are worth at their plans' prices, per plan and month by month, and export the figures as CSV.

The financial report shows what your hosting accounts are worth at their plans' prices, and how the accounts changed month by month. Open it under **Hosting > Financial Report**. You need the `customers.read` permission.

> **Important:**
These are expected amounts from plan prices, not payments received. VaultPanel does not take payments: your billing system invoices and charges customers, so its own reports show what was actually paid.

## Choosing the period

Pick **Last 3**, **6**, **12**, **24** or **36 months** at the top of the page (12 by default). The period starts on the first day of the oldest month, in UTC, and ends now.

## Summary

| Figure | How it is computed |
| --- | --- |
| **Expected each month** | For each plan, its monthly price times its active accounts, added up. The caption counts the paying accounts: active accounts on plans with a price above zero. |
| **Expected each year** | Expected each month times 12, at today's accounts and prices. |
| **On hold (suspended)** | The monthly price of every suspended account, added up. |
| **Accounts** | Accounts added and removed during the period, and how many are active now. |

A plan's **monthly price** spreads its price over a month: a quarterly price is divided by 3 and a yearly one by 12. Free plans count as 0. Plans without a price are left out of every amount, and the page warns how many active accounts are on such plans.

Totals are kept per currency and never converted. When plans use more than one currency, the page lists each currency's monthly total.

## By plan

One row per plan with its billing cycle and price, its active and suspended accounts today, what it is expected to bring in each month (monthly price times active accounts) and the amount on hold (monthly price times suspended accounts). Plans not offered for new accounts are marked **Not offered**, and plans without a price **No price**.

## Month by month

One row per month of the period:

| Column | Meaning |
| --- | --- |
| **New accounts** | Accounts created in that month. |
| **Removed accounts** | Accounts removed in that month. |
| **Suspensions** | Successful suspensions recorded in the audit log in that month. |
| **Accounts at month end** | Accounts open at the end of the month, suspended ones included. For the current month, accounts open now. |
| **Expected per month** | Those accounts priced at their plans' monthly prices, per currency. |

Plan changes are not kept per month, so past months use each account's **current** plan.

## Export

**Download CSV** saves the report as `vaultpanel-financial-report-<date>.csv` with the by-plan table and the month-by-month table, amounts in the currency's major unit (for example `9.99`).

## Through the API

`GET /api/v1/hosting/reports/financial?months=12` returns the same report as JSON, with amounts in cents. See the [hosting API reference](https://docs.vaultpanel.net/api-reference/hosting).
