v1
latestOpenAPI 3.0.22026-07-141713124.8 KBElectricity Usage Estimate
This endpoint returns a home’s expected electricity usage (in kWh) over a 12-month period, as well as the carbon footprint, utility rate, expected bill, and more. Our best-in-class machine learning model is trained on millions of data points and is constantly being updated with new information to create a personalized estimation output to every home.
There are a number of ways this API can be used, depending on the amount of data you already have.
Case 1 (Zip Code Only): The minimum input required is a zip code. This allows us to apply weather and climate data in order to return a usage prediction for the average home in the area
Case 2 (Full Address): This is the most common use case. You provide the address of the user and we take care of the rest! We use the address to fill in the rest of the fields for you.
Case 3 (Housing Data): If you don't have the address but you know some other characteristics of the home (square footage, bedrooms, etc), you can manually enter those as well and we'll apply whatever you have to the model.
Case 4 (Address and Housing Data): For the best results, you can enter both the address and the housing data. We'll trust any housing data you give us, and use the address to attempt to fill in any empty fields.
Query parameters
Our identifier for this home
The street address of the property
City of the property
State of the property as a two letter code (e.g. "TX")
5-digit zip code of the property
The year the home was built. Should be four digits.
The number of bedrooms in the home.
The number of bathrooms in the home.
The square footage of the home.
The number of stories in the home.
The house type. Either house or apartment.
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.
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.
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.
The end date for the estimation period, formatted as MM/DD/YYYY. This field is required only if start_date is present.
Response
OK