---
title: "Get All Electricity Details For A Property"
method: GET
path: "/electricity"
tags: ["Electricity"]
---

# Get All Electricity Details For A Property

`GET /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

## Query parameters

- `wattkey` string
- `address` string
- `city` string
- `state` string
- `zip` string, required
- `utility_eid` number
- `year_built` number
- `bedrooms` number
- `bathrooms` number
- `sq_ft` number
- `stories` number
- `sqft_lot` number
- `house_type` 3 | 4 | 5 | 6 | 7 | 10 | 13
- `cooling_info` string
- `heating_info` string
- `heating_fuel_source` 'Electricity' | 'Fuel Oil' | 'Natural Gas' | 'None' | 'Other Fuel' | 'Propane'
- `assuming_kwh_usage` number
- `assuming_bill` number
- `start_date` string
- `end_date` string
- `has_ac` true | false
- `has_pool` true | false
- `has_solar` true | false
- `has_green_appliances` true | false
- `has_ev_charger` true | false
- `has_heat_pump` true | false
- `has_other_energy_efficiency_upgrades` true | false
- `has_battery_storage` true | false

## Response `200`

OK

- object
  - `status` string
  - `estimation` object
    - `monthly_usage_estimates` object[]
      - `x` string
      - `y` number
    - `annual_usage_estimate` string
    - `incomplete_data` boolean
  - `solar` object
    - `solar_production_monthly` number[]
    - `cost_savings_monthly` number[]
    - `upfront_cost` number
    - `payback_period` number
    - `solar_property_page` string
  - `carbon_footprint` object
    - `annual_carbon_footprint` number
    - `baseline_annual_carbon_footprint` number
    - `baseline_annual_usage` number
    - `estimated_generation_data` object[]
      - `type` string
      - `value` number
  - `cost` object
    - `est_bill_range` object
      - `max` number
      - `min` number
    - `monthly_cost` number[]
    - `avg_rate` number
  - `energy_score` number
  - `deregulated` boolean
  - `wb_property_page` string
  - `wattkey` string — wattkey will be used to call Offers API

## Other responses

- `204` — Unable to find address
- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/wattbuy/apis/wattbuy-apis.md) · [All operations](https://skmtc.net/wattbuy/apis/wattbuy-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wattbuy/wattbuy-apis/revisions/97771153b652/schema)