Your bill and running charges, step by step
How to read what you are charged, see this month's charges as they build up, day by day, and get them by email or from your own server. Everything here is at the prices on your agreement. The fields are in the reference: Your running charges and What you have used.
You need: a dashboard sign-in, or an API key and one of plycdn's server packages (ASP.NET Core, Node.js or Python).
1Read your bill
In the dashboard, open Billing & usage → Usage. Each line shows what you used, what your plan includes, what is billable, the rate and the amount. The month's statement is issued after the month ends; until then the page is a preview of it.
- A GB is 1,000,000,000 bytes, everywhere: on the bill, in the dashboard and in your storage limits (from November
2026; earlier months were billed at 1,073,741,824 bytes). GB quantities are written with two decimals, such as
1,675.42 GB, and never in TB. - The statement's CSV gives each GB quantity in bytes too, in its last column,
Quantity (bytes).
2Rates by band
Some lines, such as delivery, are priced in bands: one rate up to a quantity, another after it. On such a line the Rate
column shows the rate of the band you are in now; point at it to see each band, how much of the month went through it
and what it came to. The bands add up exactly to the line's amount. From the API the same is currentRate and
appliedRates on the line, and the PDF statement lists each band.
3Provisional figures
Delivery and storage-API figures settle a few days after the day, once the networks that served them have reported them. Until then the dashboard shows them as provisional: an estimate at your prices, on the band they land in, marked beside the line and summed under the total as Not settled yet. They are never part of the total; each day is billed once it settles, and its figure can still change until then. A closed statement carries no provisional figures.
4See this month's running charges
Open Billing & usage → Costs (search for "costs" or "charges" from the search bar, or use See this month's running charges on Home).
- Settled so far is every day that has settled; Not settled yet is the estimate; Heading for adds the two.
- By day shows what settled each day, with a day still waiting to settle labelled provisional and its estimate apart.
- By line shows each line this month so far.
- Choose a month at the top; the month and the organization you are looking at stay in the page address, so a link to the page opens the same view. A sub-organization sees its own lines only, at list prices (your account's included quantities and bands apply to the account as a whole).
5The daily usage email
Each member can have yesterday's charges and the month so far emailed every morning (after 03:30 UTC). It is off until you turn it on: open Account & security → Profile & organization, Your profile tab, and switch on Send me the daily usage email. It goes only to you, at the address you sign in with, for your account's main organization (members of a sub-organization do not receive it); switch it off the same way. "Yesterday" is the day in your account's time zone.
6From your server
The same figures as the Costs page, for your own reports or alerts: GET /api/content/v1/usage/charges?month=YYYY-MM
(the current month when month is left out), with your API key, from your server only.
ASP.NET Core
var charges = await content.GetChargesAsync(organizationId, "2026-11");
Console.WriteLine(quot;{charges.SettledTotal} {charges.Currency} settled, {charges.ProvisionalTotal ?? 0} not settled yet");
foreach (var day in charges.ByDay)
Console.WriteLine(quot;{day.Day}: {day.Amount} (estimate {day.Provisional})");
With the storage and video packages, the same call is on PlycdnOrganizationApi: organization.GetChargesAsync(...).
Node.js
const charges = await content.getCharges(organizationId, { month: '2026-11' });
console.log(charges.settledTotal, charges.currency, charges.provisionalTotal ?? 0);
With @plycdn/node, the same call is on PlycdnOrganizationApi from @plycdn/node/account.
Python
charges = content.get_charges(organization_id, month="2026-11")
print(charges["settledTotal"], charges["currency"], charges.get("provisionalTotal") or 0)
With plycdn, the same call is on PlycdnOrganizationApi from plycdn.account (and AsyncPlycdnOrganizationApi).
The browser packages do not carry it: charges are for whoever runs the account, so they stay on your server.
7Check it works
- Open Billing & usage → Costs for this month: the days up to today are listed, and Settled so far equals the sum of the By day amounts.
- Call
GET /usage/chargesfrom your server:settledTotalis the same figure, and the days'amountvalues add up to it. - Compare with Billing & usage → Usage: the estimate shown as Not settled yet under its total matches
provisionalTotal.
8Errors
| Code | Status | What to do |
|---|---|---|
invalid_period |
400 | month is not YYYY-MM. Send a month such as 2026-11, or leave it out for this month. |
organization_forbidden |
403 | The organization id is not yours or one of your sub-organizations. |
usage_unavailable |
503 | The figures cannot be worked out right now; nothing about the request is wrong. Try again shortly. |
settledTotal is null while no prices are set on your agreement: your use is still counted, and Usage shows the
quantities. Contact us to set your prices.