The Spending page: hour-by-hour ledger, CSV/PDF, monthly statement email and API
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
- Pick the Start and End dates (default: from the start of this month to today).
- Optionally narrow by Service, Status and Search item.
- Choose Daily or Monthly from Totals.
- 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.
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.
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).
# 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.
The billing commands are in gyro CLI 1.10 and later (Installing the gyro CLI).
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).
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).
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
Thanks for your feedback!