Plans & addons
An operator's plan catalog is built on top of Helium MVNE's carrier profiles — bundles of SLOs (data caps, throttle tiers, voice/SMS allowances) that a carrier makes available to MVNOs. T-Mobile profiles are shipped with the platform; you pick from them and price.
Carrier profiles vs plans
| Carrier profile | Plan | |
|---|---|---|
| Owned by | Helium MVNE (per carrier) | Your operator |
| Mutable | No (carrier-defined) | Yes |
| Priced | No | Yes |
A plan is { carrier_profile_id, price, currency, billing_period, name, change_policy, addons[] }.
Addons
Addons extend a plan with optional SLOs (e.g. extra hotspot data, international calling). They're attached to a subscription, not to a plan — one plan can support many addon combinations.
POST /v1/subscriptions/{id}/addons
addon_id, effective_at?
Plan changes
A subscription's plan is mutable. The plan's change_policy
controls proration:
immediate— effective now, proratednext_period— effective at next billing date, no prorationend_of_term— effective at contract end (rare; for committed terms)
Plan changes that downgrade SLOs are subject to carrier validation — see the T-Mobile SLO catalog in the operator's carrier profile reference.