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

# Utility Information Lookup

`GET /electricity/info`

## Request

- Base URL: `https://apis.wattbuy.com/v3`
- URL: `https://apis.wattbuy.com/v3/electricity/info`
- Auth: API key in header `x-api-key`

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' | 'regulated_zip': 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
    - `phones` object[]: Phone numbers for the utility, such as customer service and outage lines. Not available for every utility; omitted when there are no phone numbers.
      - `number` string: E.164 format. Use this for dialing, `tel:` links and matching.
      - `display` string: Human-readable form, including vanity spellings (e.g. `1-888-LIGHTKC`).
      - `extension` string, nullable
      - `purpose` 'customer_service' | 'outage' | 'signup'
      - `label` string, nullable: Location or department the number belongs to.
      - `toll_free` boolean
      - `hours` string, nullable: Free-text hours when the number is staffed.
      - `is_primary` boolean: True for the first number of each `purpose`.
    - `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` integer: Utility id. US utilities use the EIA id; non-US utilities use a WattBuy-reserved block that cannot collide with one (Canada = 124000001+). This is the value to pass as `utilityID` to `/electricity/retail-rates` and as `utility_eid` elsewhere.
    - `utility_id` integer: Present only for deregulated utilities; same value as `eid`.
    - `country` 'us' | 'ca': Country the utility operates in. Absent or `us` for US utilities.
    - `utility_key` string: Stable human-readable short code for non-US utilities (e.g. `bchydro`). Informational only — it is **not** an id accepted by any endpoint; use `eid`.
    - `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
    - `avg_price` string: Average residential price in cents/kWh, as a string.
    - `customers` integer: Number of customers the utility serves.
    - `subdivisions` UtilitySubdivision[]: Optional. Present only for utilities whose pricing varies by area within their territory (e.g. PG&E climate zones). Lists every subdivision the utility has; the one matched to the requested location is in `subdivision_id`.
      - `id` string: Stable subdivision id.
      - `label` string: Display name.
      - `type` string: Kind of subdivision.
      - `varies` string[]: Which rate components differ across this utility's subdivisions.
      - `aliases` string[]: Alternate names the subdivision is known by.
    - `subdivision_id` string: Optional. The `id` of the subdivision (from `subdivisions`) resolved for the requested ZIP. Present only for US utilities that have subdivision data for that ZIP. When present it is always set, even when the ZIP spans several subdivisions; in that case check `subdivision_low_confidence` and `subdivision_candidates`.
    - `subdivision_type` string: Optional. The `type` of the resolved subdivision.
    - `subdivision_confidence` number, float, nullable: Optional. Confidence (0–1) that `subdivision_id` is correct for the requested ZIP. `null` when unknown.
    - `subdivision_low_confidence` boolean: Optional. `true` when the match is uncertain (typically confidence below 0.5, e.g. a ZIP that spans several subdivisions) and should be confirmed with the user.
    - `subdivision_candidates` object[]: Optional. Present only when the ZIP spans more than one subdivision. Lists every subdivision that could apply, including the one in `subdivision_id`.
      - `subdivision_id` string
      - `confidence` number, float
      - `share` number, float: Share of the ZIP that falls in this subdivision (0–1).
  - `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` integer: Utility id. US utilities use the EIA id; non-US utilities use a WattBuy-reserved block that cannot collide with one (Canada = 124000001+).
    - `utility_name` string
    - `type` 'regulated' | 'deregulated'

## Other responses

- `204`: Unable to find address/zipcode
- `400`: Bad request
- `500`: Internal server error

## Changes

- **2026-11-03** `443ce1657edb`: 2 breaking, 1 warning, 11 info
  - the `utility_info/items/utility_id` response's property type changed from `string` to `integer` for status `200`
  - the `utility_list/items/utility_eid` response's property type changed from `string` to `integer` for status `200`
  - added the new `regulated_zip` enum value to the `exact_match_reason` response property for the response status `200`
  - added the optional property `utility_info/items/avg_price` to the response with the `200` status
  - …10 more

[Operation history](https://skmtc.dev/wattbuy/apis/wattbuy-apis/changes/electricity/info/get.md)

---

[API](https://skmtc.dev/wattbuy/apis/wattbuy-apis.md) - [All operations](https://skmtc.dev/wattbuy/apis/wattbuy-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wattbuy/apis/wattbuy-apis/revisions/443ce1657edb?raw)
