---
title: "Utility Information Lookup"
method: GET
path: "/electricity/info"
tags: ["Electricity"]
---

# Utility Information Lookup

`GET /electricity/info`

This endpoint returns the key details about the electric utility serving a particular location. Pass in a user’s location and return the utility name, phone number, web address, and any other key information available.

Both US and Canadian locations are supported. For a Canadian location the response includes a `country` field set to "ca".

## Query parameters

- `wattkey` string
- `address` string
- `city` string
- `state` string
- `zip` string, required
- `zip_fallback` boolean
- `housing_chars` true | false
- `utility_list` true | false

## Response `200`

OK

- object
  - `type` 'regulated' | 'deregulated' — The type of energy service for the address, either regulated or deregulated.
  - `esiid` string — The Electric Service Identifier (ESID) of the address.
  - `exact_match` boolean — Indicates whether the search results are an exact match to the address searched.
  - `exact_match_reason` 'success' | 'multiple_addresses_found' | 'unknown' | 'address_unavailable' — The reason for the exact match result, if applicable.
  - `utility_info` Distributor[] — An array of objects containing information about the addresses's utility provider. Not all objects will return for every utility.
    - `name` string
    - `abbreviation` string
    - `state` string
    - `place` string
    - `zip` string
    - `service_territory` string
    - `phone_number` string
    - `parent/holding_organization` string
    - `website` string
    - `twitter` string
    - `facebook` string
    - `outage_hotline` string
    - `outage_map` string
    - `green_button_access` string
    - `green_button_landing_page` string
    - `green_button_reference_page` string
    - `utility_location` boolean
    - `ownership` string
    - `nerc_location` string
    - `nerc_ercot` boolean
    - `activity_transmission` boolean
    - `activity_buying_transmission` boolean
    - `activity_distribution` boolean
    - `activity_buying_distribution` boolean
    - `alt_fuel_vehicle` boolean
    - `alt_fuel_vehicle2` boolean
    - `signup_url` string
    - `signup_phone_number` string
    - `utility` string
    - `is_deregulated` boolean
    - `description` string
    - `holidays_list` object[]
      - `name` string
      - `adjust` string
    - `is_supported` boolean
    - `utility_name` string
    - `on_sitemap` boolean
    - `sitemap_id` string
    - `preferred_name` string — The name under which the utility does business and the best option for displaying utilities to customers for selection.
    - `has_re_visible` boolean
    - `eid` number
    - `utility_id` string
    - `company_id` string
    - `source_url` string
    - `source_page` string
    - `utility_rates` object
    - `default_rate` number
    - `distributor_monthly_rate` number
    - `distributor_rate_per_kwh` number
    - `time_of_use_rate` number
  - `housing_chars` object[] — An array of objects containing information about the house located at the provided address. Not all objects will return for every address.
    - `use_code` string
    - `bedrooms` number
    - `bathrooms` number
    - `year_built` string
    - `sq_ft` number
    - `stories` number
    - `house_type` string
    - `has_ac` boolean
    - `has_pool` boolean
    - `has_solar` boolean
    - `has_green_appliances` boolean
  - `wattkey` string — The unique identifier for the address used to call the address again in other API endpoints.
  - `utility_list` object[] — An array of objects containing all electric utilities in the state, for the purpose of being able to provide users with an alternatives list if the address to utility match is incorrect.
    - `utility_eid` string
    - `utility_name` string
    - `type` 'regulated' | 'deregulated'

## Other responses

- `204` — Unable to find address/zipcode
- `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)