Documentation » Get Utility Companies

https://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
Request Parameters
Response Fields
Examples
- JSON Output Format
- XML Output Format
Errors

Request URL

GET https://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.
scope	No	Options: US or international Default:US	U.S. utility companies only, or specify international scope for all companies.
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

GET https://api.openei.org/utility_companies?version=latest&format=json&api_key=EXAMPLE_API_KEY

    
          {"properties": {},
      "items": [
          {"label": "3 Phases Energy Services",
           "uri":"https://openei.org/wiki/3 Phases Energy Services"},
          {"label": "4-County Electric Power Assn",
           "uri":"https://openei.org/wiki/4-County Electric Power Assn"},
          {"label": "A & N Electric Coop",
           "uri":"https://openei.org/wiki/A & N Electric Coop"}]

Errors

Returns a description of the error

Web Services