Account Billing Summary
Returns the billing summary for your active account. Billing in Ngris is account-level: the account owner holds the payment method and subscription, and everything created in the account bills against the owner's plan. Members of the account share its plan and entitlements.
Use this to render the plan and feature-availability state for the account. Requires the billing:read permission.
Response (200 OK)
account_id int64
The active account this summary describes.
plan_id int64
The plan the account is on. May be
null on a free account with no explicit plan.subscription_status string
Subscription state for the account's plan (e.g.
active, trialing, past_due). null when the account has no paid subscription.entitlements object[]
The feature entitlements granted by the account's plan. Each entry has
feature_key (the feature, e.g. custom_subdomains), enabled (whether the feature is on), and an optional limit_value (a numeric cap for metered features). Empty when the account has no plan.Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or you lack the
billing:read permission in this account.404 Not Found
The active account no longer exists.
Request
curl "https://api.ngris.com/v1/account/billing" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
billing = client.account.get_billing()
print(billing["subscription_status"])
Response — 200 OK
{
"account_id": 42,
"plan_id": 3,
"subscription_status": "active",
"entitlements": [
{
"feature_key": "custom_subdomains",
"enabled": true,
"limit_value": null
},
{
"feature_key": "dedicated_ports",
"enabled": true,
"limit_value": 5
}
]
}