List Add-ons
Optional paid add-ons that are switched on for this deployment, with their current price. Only enabled add-ons are returned; an add-on an administrator has switched off (for example the dedicated IP add-on today) does not appear. The extended log retention add-on is priced per day of extra retention, with one entry per billing cadence.
Use this to render the "Add-ons" section of the billing page. The account's active add-ons appear in the billing/subscription endpoints, not here.
Response (200 OK)
An object with an items array of add-on objects:
key string
Stable identifier (for example
retention_day_monthly, retention_day_yearly, dedicated_ip).name string
Display name.
description string
Sentence-long description of what the add-on does. Empty string when none is set.
unit_amount_cents int64
Price of one unit in the smallest currency unit (cents). For the retention add-on one unit is one extra day.
currency string
Lowercase ISO 4217 code, for example
usd.interval string
month, year, or one_time (a setup fee).The response example leaves out unit_amount_cents: prices change, so read the current one from the response.
Errors
401 Unauthorized
Missing or invalid auth.
Request
curl "https://api.ngris.com/v1/addons" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
for a in client.regions.list_addons()["items"]:
print(a["key"], a["unit_amount_cents"], a["currency"], a["interval"])
Response — 200 OK (price left out)
{
"items": [
{
"key": "retention_day_monthly",
"name": "Extended log retention (per day, monthly)",
"description": "Per-day price for extra traffic-log retention on monthly subscriptions; billed days × this amount.",
"currency": "usd",
"interval": "month"
}
]
}
Was this helpful?