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 × discount

The 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/pdf

GET /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