Read the utility billing policy
LogsGET /billing-policy
Returns the tenant's billing policy: default due days, grace period, the default volume used for missing readings, and the late penalty settings (kind, amount or rate, frequency, interval, cap, tax and compounding, and exclusions for disputed invoices and payment plans). A tenant that never saved a policy gets the default policy. Requires tariffs:read.
Returns
200 Billing policy
Show attributes
tenant_iddefault_due_daysgrace_period_daysdefault_missing_reading_m3Default consumption in m3 used when a reading is missing and no history exists.
late_penalty_enabledlate_penalty_kindlate_penalty_amount_minorlate_penalty_rate_basis_pointslate_penalty_frequencylate_penalty_interval_dayslate_penalty_cap_minorlate_penalty_taxablelate_penalty_compoundexclude_disputed_from_penaltyexclude_payment_plan_from_penaltyversionupdated_at
Permissions tariffs:read · Roles: admin, analyst, billing_clerk, customer_service, finance, owner, viewer
curl -X GET "$BUSINESS_API/billing-policy" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/billing-policy", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/billing-policy",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/billing-policy", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"default_due_days": 125000,
"grace_period_days": 1,
"default_missing_reading_m3": 13.42,
"late_penalty_enabled": true,
"late_penalty_kind": "late penalty kind",
"late_penalty_amount_minor": 125000,
"late_penalty_rate_basis_points": 1,
"late_penalty_frequency": "late penalty frequency",
"late_penalty_interval_days": 1,
"late_penalty_cap_minor": 1,
"late_penalty_taxable": true,
"late_penalty_compound": true,
"exclude_disputed_from_penalty": true,
"exclude_payment_plan_from_penalty": true,
"version": 1,
"updated_at": "2026-11-19T09:30:00Z"
}