Returns upfront rebates and ongoing (DR/VPP) programs available to a residential customer at a given location, across all electrification-relevant technologies (solar, battery, EV, heat pump, water heater, insulation, appliance, etc.).

The response includes:

• upfront[] — at-purchase rebates and tax credits, ordered by confidence + provider preference + max amount
• ongoing[] — recurring/performance programs (demand response, VPP, time-of-use bonuses)
• totals — estimated dollar values when system_cost and/or system_size_kw are provided
• meta — debug info: which aggregators expanded the result, confidence floor used

Aggregator expansion: when the customer's utility belongs to one or more aggregators (Mass Save, TVA EnergyRight, Energize CT, etc.), programs administered by those aggregators are automatically included. Same routing applies to ongoing programs (aggregator_id, installer_service_eids scoping for installer-VPPs like Sunrun-SCE).

Confidence filtering: by default only HIGH records surface. Pass min_confidence: 'MEDIUM' (or lower) to opt in to less-certain records. Confidence reflects whether the record is authority-confirmed (HIGH) versus hint-only from third-party databases like DSIRE (MEDIUM). The VERIFIED tier was historically present but consolidated into HIGH in May 2026 — VERIFIED is still accepted as a valid min_confidence for backwards compatibility but produces the same set as HIGH.