Nova works with credit. A payment puts credit on the account, and the plan and the usage are paid from that credit. These endpoints show the plans, create payments and list what was paid.
All amounts are in micro-euro: 1000000 is €1.
GET /misc/subscriptions#
Returns the plans an account can have. No API key is needed.
curl https://nova.storage/api/misc/subscriptions[
{
"id": "luna",
"name": "Luna",
"type": "subscription",
"monthly_fee": 2000000,
"min_months": 6,
"file_size_limit": 100000000000,
"storage_limit": 1000000000000,
"price_per_tb_storage": 4000000,
"price_per_tb_bandwidth": 1000000,
"monthly_transfer_cap": 2000000000000,
"file_sharing": true
}
]| Field | Meaning |
|---|---|
id |
The ID of the plan, to order it with |
name |
The name of the plan |
monthly_fee |
Price per month, without VAT |
min_months |
The shortest period the plan can be ordered for, in months |
file_size_limit |
Largest file which can be uploaded, in bytes |
storage_limit |
Storage in bytes |
monthly_transfer_cap |
Transfer per 30 days in bytes |
price_per_tb_storage |
With usage based billing: price per month of a TB of storage above the limit |
price_per_tb_bandwidth |
With usage based billing: price of a TB of transfer above the limit |
file_sharing |
Whether files can be shared with this plan |
A plan can be ordered for 1, 6 or 12 months. A period of 6 months is 10% cheaper and a period of 12 months is 20% cheaper. The price of a period is:
monthly_fee × months × discountThe subscription field of GET /user has the same
format. The free plan is not in this list. It has an empty id.
Charges#
The plan is charged from the credit every day. A day costs monthly_fee × discount, divided by the 30.4375 days of an average month.
Storage and transfer above the limits of the plan are refused, unless
usage_based_billing is on for the account, see PUT /user.
Then this usage is charged together with the plan: price_per_tb_storage per
TB per month, and price_per_tb_bandwidth per TB.
When the credit is used up the balance goes below zero and the user gets an e-mail. The plan keeps working for a week. If the balance is still negative after that week, the account goes back to the free plan. The files stay.
Usage above the limits is charged afterwards, so it is only allowed while the balance is not further below zero than the price of the subscription period. After that the limits of the plan apply again, until credit is added.
GET /misc/vat_rate/{country}#
Returns the VAT we charge in a country. No API key is needed.
{country} is a country code of two or three letters, or the English name of
the country.
curl https://nova.storage/api/misc/vat_rate/NL{"alpha2": "NL", "alpha3": "NLD", "vat": 0.21, "name": "Netherlands"}vat is a fraction: 0.21 is 21%. It is 0 for countries outside the European
Union. For a country which does not exist all the names are None.
POST /user/invoice#
Creates an invoice to put credit on the account, and returns where the user can pay it.
Permission: billing_write.
| Parameter | Required | Value |
|---|---|---|
amount |
yes | The credit to buy, 10000000 (€10) or more. The VAT of the country comes on top of this |
network |
yes | The payment method, see below |
country |
yes | Country of the user, as a code of two or three letters |
name |
for ideal and p24 |
Full name of the user, 3 to 300 characters |
subscription |
no | The id of a plan to start when the invoice is paid |
subscription_months |
no | The period of that plan: 1, 6 or 12. Without it the shortest period of the plan is used |
The payment methods:
network |
Method |
|---|---|
mollie |
The payment page of Mollie, where the user picks a method |
paypal |
PayPal |
ideal |
iDEAL (Netherlands) |
bancontact |
Bancontact (Belgium) |
eps |
EPS (Austria) |
p24 |
Przelewy24 (Poland) |
trustly |
Trustly |
btc, btc_lightning, doge, xmr, ltc |
Bitcoin, Bitcoin over Lightning, Dogecoin, Monero, Litecoin |
curl -u ":$NOVA_KEY" \
-d amount=20000000 -d network=mollie -d country=NL \
https://nova.storage/api/user/invoice{
"invoice_id": "tr_WDqYK6vllg",
"checkout_url": "https://www.mollie.com/checkout/select-method/WDqYK6vllg"
}invoice_id and checkout_url come from the company which handles the
payment, so they look different for each method. Send the user to
checkout_url in a browser. The credit is added to the
account when the payment arrives, which can take a while with some methods.
When a plan is ordered with the invoice, the amount plus the credit which is on the account already has to be enough for the whole period. The errors are the same as for changing the plan.
GET /user/invoice#
Lists the invoices of the account.
Permission: billing_read.
[
{
"id": "tr_WDqYK6vllg",
"time": "2026-10-02T15:04:05.123Z",
"amount": 20000000,
"vat": 4200000,
"country": "NLD",
"payment_gateway": "mollie",
"payment_method": "mollie",
"status": "paid"
}
]| Field | Meaning |
|---|---|
id |
The ID of the invoice |
time |
When the invoice was created |
amount |
The credit which was bought, without VAT |
vat |
The VAT which was charged on top |
country |
The country the invoice was made for |
payment_gateway |
What handles the payment: mollie, paypal or btcpay_server |
payment_method |
The network the invoice was created with |
status |
open, processing, paid, expired, canceled or refund |
GET /user/invoice/{id}/pay#
Sends the browser to the page where an invoice can be paid, with a redirect. If the invoice can’t be paid anymore the redirect goes back to the website.
Permission: billing_read.
GET /user/invoice/{id}/pdf#
Returns an invoice as a PDF file.
Permission: billing_read.
curl -u ":$NOVA_KEY" -o invoice.pdf \
https://nova.storage/api/user/invoice/tr_WDqYK6vllg/pdfGET /user/transactions/{month}#
Lists what was added to and taken from the credit of the account in a month.
{month} has the format 2026-10. Charges are negative amounts.
Permission: billing_read.
[
{
"time": "2026-10-02T00:01:00.079Z",
"new_balance": 24500000,
"deposit_amount": 0,
"subscription_charge": -525667,
"storage_charge": -65708,
"storage_used": 500000000000,
"bandwidth_charge": 0,
"bandwidth_used": 0,
"affiliate_amount": 0,
"affiliate_count": 0
}
]| Field | Meaning |
|---|---|
time |
When the transaction was made |
new_balance |
The credit after this transaction |
deposit_amount |
Credit which was added by a payment |
subscription_charge |
What was charged for the plan |
storage_charge |
What was charged for storage above the plan |
storage_used |
The storage above the plan which was charged, in bytes |
bandwidth_charge |
What was charged for transfer above the plan |
bandwidth_used |
The transfer above the plan which was charged, in bytes |
affiliate_amount |
Credit which was earned with the affiliate program |
affiliate_count |
The number of users it was earned with |
Changing the plan#
The plan is changed with PUT /user, which needs the
billing_write permission:
curl -u ":$NOVA_KEY" -X PUT \
-d subscription=sol -d subscription_months=6 \
https://nova.storage/api/user| Parameter | Value |
|---|---|
subscription |
The id of the new plan. An empty value is the free plan |
subscription_months |
The period: 1, 6 or 12. Without it the shortest period of the plan is used |
The account needs enough credit to pay for the whole period. If it does not have that, create an invoice with the plan in it instead. The plan then starts when the invoice is paid.
| Status | value |
Meaning |
|---|---|---|
| 400 | invalid_subscription |
There is no plan with this ID, or the period is not 1, 6 or 12 |
| 400 | subscription_period_too_short |
The plan can’t be ordered for a period this short. The shortest one is in extra.min_months |
| 400 | not_enough_credit |
The credit does not cover the period. extra.price_micro_eur is the price of the period and extra.shortfall_micro_eur is what is missing |
| 400 | plan_storage_too_small |
The account stores more than the plan allows. extra.storage_limit and extra.storage_used are in bytes |