Get All Electricity Details For A Property

get

https://apis.wattbuy.com/v3/electricity

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

wattkey

string

Our identifier for this home

address

string

The street address of the property

city

string

City of the property

state

string

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

zip

string

required

5-digit zip code of the property

utility_eid

number

EID of Utility which is getting in electricity info API

year_built

number

Year the home was built

bedrooms

number

Number of bedrooms in the home

bathrooms

number

Number of bathrooms in the home

sq_ft

number

Square footage of livable indoor area

stories

number

Number of floors in the home

sqft_lot

number

Square footage of the lot

house_type

number

enum

Allowed:

cooling_info

string

heating_info

string

heating_fuel_source

string

enum

Allowed:

assuming_kwh_usage

number

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_bill

number

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_date

string

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_date

string

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

has_ac

boolean

enum

Allowed:

has_pool

boolean

enum

Allowed:

has_solar

boolean

enum

Allowed:

has_green_appliances

boolean

enum

Allowed:

has_ev_charger

boolean

enum

Allowed:

has_heat_pump

boolean

enum

Allowed:

has_other_energy_efficiency_upgrades

boolean

enum

Allowed:

has_battery_storage

boolean

enum

Allowed:

Responses

204

Unable to find address

500

Internal server error

200OK

400Bad request