# The Spending page: hour-by-hour ledger, CSV/PDF, monthly statement email and API

https://www.gyrohosting.com/en/knowledgebase/article/spending-page-hour-by-hour-ledger

- **What you will learn**: How to follow the spending of your prepaid services in the panel, how to filter and download the hour-by-hour ledger, the monthly statement email, and how to reach the same data through the API and command line.
- **Time**: 8 minutes
- **Who this is for**: People using Gyro Cloud Istanbul or Gyro Containers; accounting and developer teams.
- **What you need**: At least one prepaid service or a topped-up balance.

## 1. Open the page

In the client area choose **Spending** from the left menu. The page shows only the usage of your prepaid services (Gyro Cloud Istanbul, Gyro Containers).

The four cards at the top:

| Card | What it shows |
| --- | --- |
| **Balance** | Your current balance and a **Top up** button |
| **Hourly cost** | Total hourly cost of all running prepaid items, its daily equivalent and the euro rate used |
| **Estimated time left** | How many hours/days your balance lasts at the current rate ("until about 23.11.2026 13:43") |
| **Running prepaid services** | Number of running services (suspended ones are noted separately) |

The estimated time is colour-coded: **green above 72 hours, amber between 24 and 72 hours, red below 24 hours**. If "pay my invoices from balance" is on, invoices that will be paid from the balance within 7 days are included and noted.

## 2. Filter and read the ledger

1. Pick the **Start** and **End** dates (default: from the start of this month to today).
2. Optionally narrow by **Service**, **Status** and **Search item**.
3. Choose **Daily** or **Monthly** from **Totals**.
4. Press **Filter**.

The page shows three sections:

- **Daily (or monthly) totals:** day, hours and amount.
- **By service:** total hours and amount per service and item.
- **Hourly detail:** each row is one hour of one item.

### Hourly detail columns

| Column | Meaning |
| --- | --- |
| Hour | The hour charged (Istanbul time) |
| Service / Item | Service number and item name: server plan, container environment, node, image registry, extra disk, extra IP and so on |
| Status | **Charged**, **Monthly cap** (free because the cap was reached), **Partly paid**, **Unpaid (no balance)** or **Free** |
| Power | Whether the server was running or off that hour (informational; powered-off servers are charged too) |
| Unit price (EUR/hour) | The hourly euro price of the item |
| EUR rate | The rate used for that hour |
| Unit price / Amount | The TRY equivalent and the amount deducted |

Metered items (such as the image registry) also show the quantity, for example `Image registry · 3.4 GB (−2 GB)`: 2 GB are free, so only the excess is charged.

> **Info**
> 
> The ledger cannot be edited: rows are only added. Every day the sum of the hourly rows is checked against the daily line on the Account Balance page.

## 3. Download as CSV or PDF

After applying your filter, press **CSV** (hourly rows for spreadsheets) or **PDF** (readable summary). The file covers the date range and filter you chose.

> **Warning**
> 
> The CSV and PDF are a **usage statement, not an invoice.** The official invoice is issued when you top up; use that invoice for your accounting.

## 4. The daily summary on the Account Balance page

The Spending page shows the detail; the **Account Balance** page shows a daily summary. There you find **one line per service per day**, for example "#47685 · 11.11.2026 · 14 hours of usage (from balance, not an invoice)". The line grows hour by hour during the day. This keeps your balance history tidy; the detail lives on the Spending page.

## 5. Monthly statement email

On the **1st of every month** you receive the previous month's usage statement by email (marked "not an invoice"). You can get the same statement for any month from the panel or with the command below.

## 6. API and command line

You can reach the spending data through the API and the `gyro` command line. When creating the API key tick the **billing read** permission (`billing_read`) ([First steps with the Gyro API](https://www.gyrohosting.com/en/knowledgebase/article/gyro-api-ilk-adim)).

```
# Balance, hourly load and estimated time left
gyro billing balance get

# This month's hourly ledger (all pages)
gyro billing usage list --all

# Daily totals, one service, a date range
gyro billing usage list --granularity day --service-id 12345 --from 2026-11-01 --to 2026-11-30

# Only rows hit by the monthly cap
gyro billing usage list --status tavan

# Monthly statement: table, PDF and CSV
gyro billing statement get 2026-11
gyro billing statement get 2026-11 --format pdf
gyro billing statement get 2026-11 --format csv

# Link to the top-up page
gyro billing topup-url get
```

HTTP equivalents: `GET /cloud/billing/balance`, `/cloud/billing/usage`, `/cloud/billing/statement/{month}`, `/cloud/billing/topup-url`, and `POST /cloud/billing/estimate` for cost calculation.

> **Info**
> 
> The `billing` commands are in **gyro CLI 1.10 and later** ([Installing the gyro CLI](https://www.gyrohosting.com/en/knowledgebase/article/gyro-cli-kurulum)).

## 7. Frequently asked questions

**Why is there no invoice number on the Spending page?**

No invoice is issued for prepaid usage; the invoice is issued when you top up. You find your top-ups under **Invoices**.

**What does the "Monthly cap" status mean?**

That item reached its monthly price in that calendar month; the remaining hours are free ([How the hourly price is calculated](https://www.gyrohosting.com/en/knowledgebase/article/how-the-hourly-price-is-calculated)).

**I see an "Unpaid (no balance)" row; what should I do?**

Your balance was not enough in that hour and the service was suspended. It starts again when you top up ([Low-balance warnings, suspension and deletion](https://www.gyrohosting.com/en/knowledgebase/article/low-balance-warnings-suspension-deletion)).

**Why does my powered-off server show as charged?**

A powered-off but not deleted server is charged in full; the **Power** column shows "Off" and **Status** is still "Charged".

## Next step

- [Low-balance warnings, suspension and deletion](https://www.gyrohosting.com/en/knowledgebase/article/low-balance-warnings-suspension-deletion)
- [Stopping and deleting a prepaid service](https://www.gyrohosting.com/en/knowledgebase/article/stopping-and-deleting-a-prepaid-service)