API Reference

Retrieve residential incentive programs

post
https://apis.wattbuy.com/v3/incentives

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, top 3 per tech, ordered by confidence + provider preference + max amount
  • ongoing[] — recurring/performance programs (demand response, VPP, time-of-use bonuses), top 2 per tech
  • 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.

Confidence filtering: by default only HIGH and VERIFIED records surface. Pass min_confidence: 'MEDIUM' (or lower) to opt in to less-certain records. Confidence reflects whether the record is authority-confirmed (HIGH/VERIFIED) versus hint-only from third-party databases like DSIRE (MEDIUM).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Two-letter US state code (required)

string

Street address. Used together with city/state/zipcode to resolve the customer's electric utility (and therefore eligible utility-specific programs).

string
string

5-digit zip code

integer

EIA utility ID. Short-circuits the address→utility resolver when known.
TX TDSP customers should use the TDSP's DOE/EIA number (Oncor 44372, CenterPoint 8901, AEP TX Central 3278, AEP TX North 20404, TNMP 40051).

incentive_types
array of strings

Filter to specific tech categories. Defaults to all 16 valid types.

incentive_types
fuel_types
array of strings
Defaults to electric,agnostic,dual_fuel,electrification,fuel_agnostic

Filter by equipment fuel type. Defaults to the electrification set (excludes gas).
Pass gas explicitly to include gas-only equipment programs.

fuel_types
string
enum
Defaults to HIGH

Minimum confidence tier. Defaults to HIGH (returns only authority-confirmed records).
Set to MEDIUM to include DSIRE/AFDC/EnergyStar hint-level data; lower tiers expose increasingly uncertain records.

Allowed:
number

Total installed cost of the system. Used to estimate dollar values for pct_of_cost and tax_credit programs.

number

System size in kW. Used to estimate dollar values for per_unit programs with unit kW or W.

Responses

500

Internal server error

Updated about 11 hours ago

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 11 hours ago