v1

latestOpenAPI 3.0.22026-07-141713124.8 KB
Electricity

Get All Electricity Details For A Property

This endpoint combines our electricity estimation, solar, cost, and carbon footprint APIs into one call. This allows us to efficiently re-use components of the calculations and return all data quicker than calling all the APIs separately.

If given address not found it will return 204 status

If given address has mutliple matches it will return 400 status with relavent addresses

get/electricity

Query parameters

wattkeystring

Our identifier for this home

addressstring

The street address of the property

citystring

City of the property

statestring

State of the property as a two letter code (e.g. "TX")

zipstring required

5-digit zip code of the property

utility_eidnumber

EID of Utility which is getting in electricity info API

year_builtnumber

Year the home was built

bedroomsnumber

Number of bedrooms in the home

bathroomsnumber

Number of bathrooms in the home

sq_ftnumber

Square footage of livable indoor area

storiesnumber

Number of floors in the home

sqft_lotnumber

Square footage of the lot

house_type3 | 4 | 5 | 6 | 7 | 10 | 13
cooling_infostring
heating_infostring
heating_fuel_source'Electricity' | 'Fuel Oil' | 'Natural Gas' | 'None' | 'Other Fuel' | 'Propane'
assuming_kwh_usagenumber

This field indicates the monthly average kWh usage on the given address. If the date range is provided, the usage ML model will consider it accordingly.

assuming_billnumber

This field indicates the monthly average bill in dollars on the given address. If the date range is provided, the usage ML model will consider it accordingly. This field is not allowed if assuming_kwh_usage is present.

start_datestring

The start date for the estimation period, formatted as MM/DD/YYYY. This field is required only if either assuming_kwh_usage or assuming_bill is provided.

end_datestring

The end date for the estimation period, formatted as MM/DD/YYYY. This field is required only if start_date is present.

has_actrue | false
has_pooltrue | false
has_solartrue | false
has_green_appliancestrue | false
has_ev_chargertrue | false
has_heat_pumptrue | false
has_other_energy_efficiency_upgradestrue | false
has_battery_storagetrue | false

Response

OK

statusstring
energy_scorenumber
deregulatedboolean
wb_property_pagestring
wattkeystring

wattkey will be used to call Offers API