Documentation » Get Utility Companies

http://api.openei.org/utility_companies?params

This service returns all entries in the OpenEI category EIA Utility Companies and Aliases. It includes alias names (e.g. Xcel Energy of Colorado is an alias for Public Service Co of Colorado). The utility rate web service accepts a utility company or utility company alias for its "ratesforutility" parameter.

Request URL

GET http://api.openei.org/utility_companies?parameters

Request Parameters

Parameter Required Value Description
version Yes
Options: latest, 1, 2 or 3
 
format Yes
Options: json, or json_plain

The format parameter will be disregarded if the debug parameter is set

api_key Yes
Type: String

Register for a key here, it's free!

callback No
Type:String
callback=<mycallback> - set mycallback as the json callback.
debug No
None
Print the ask query sent to the server.

Response Fields

Field Value Description
label
Type: string

Page label.

uri
Type: URI

Full page URI.

Examples

JSON Output Format

 1
 2
 3
 4
 5
 6
 7
 8
{"properties": {},
      "items": [
          {"label": "3 Phases Energy Services",
           "uri":"http://en.openei.org/wiki/3 Phases Energy Services"},
          {"label": "4-County Electric Power Assn",
           "uri":"http://en.openei.org/wiki/4-County Electric Power Assn"},
          {"label": "A & N Electric Coop",
           "uri":"http://en.openei.org/wiki/A & N Electric Coop"}]

Errors

Returns a description of the error