Utility Information Lookup
Changed onThis 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".
Request
- Base URLhttps://apis.wattbuy.com/v3
- AuthAPI key in header x-api-key
Query parameters
Our identifier for this home
The street address of the property
City of the property
US state as a two-letter code (e.g. "TX") or a Canadian province/territory code (e.g. "NS", "QC").
US 5-digit ZIP (e.g. "75001") or Canadian postal code (e.g. "B3J 2A8").
Search utility by zipcode if address search fails
Response
OK
Example response
{
"utility_info": [
{
"phones": [
{
"number": "+18007435002",
"display": "(800) 743-5002",
"extension": "333",
"label": "Billing and Payments",
"hours": "Mon-Fri 7am-4:30pm"
}
],
"eid": 6452,
"country": "ca",
"utility_key": "bchydro",
"avg_price": "15.6",
"customers": 2122790,
"subdivisions": [
{
"id": "climate_x",
"label": "Climate Zone X",
"type": "climate_zone",
"varies": [
"baseline_allowance"
],
"aliases": [
"X",
"Zone X"
]
}
],
"subdivision_id": "climate_x",
"subdivision_type": "climate_zone",
"subdivision_confidence": 0.75,
"subdivision_candidates": [
{
"subdivision_id": "climate_6",
"confidence": 0.333,
"share": 0.333
}
]
}
],
"utility_list": [
{
"utility_eid": 3278
}
]
}Changes
- breaking
the
//response's property type changed fromstringtointegerfor status - breaking
the
//response's property type changed fromstringtointegerfor status - warning
added the new
regulated_zipenum value to theresponse property for the response status
11 more changes in this revision
- breaking