Electricity utility rates
GET {{nrel_developer_url}}/utility_rates/v3.json?format=json&lat={{ny_latitude}}&lon={{ny_longitude}}
Utility Rates (GET /api/utility_rates/v3)
This service returns annual average utility rates ($/kWH) for residential, commercial and industrial sectors as well as the local utility name for a specific location. This service does not return complex rate information.
The data source is Ventyx Research Inc. and the Energy Information Agency (EIA), and was updated with 2012 numbers.
Version 3 is the current version of the utility rates API. Previous versions have been deprecated and its users are encouraged to migrate to this newly enhanced version.
Response Fields
The response is composed of service-related informational fields and the results of the data query.
| Field | Value | Description |
|---|---|---|
| inputs | Type: collection | The input parameters received in the request. |
| version | Type: string | The current version of the web service. |
| errors | Type: array of strings | Any error messages resulting from the request. |
| warnings | Type: array of strings | Any warning messages resulting from the request. |
| metadata | Type: collection | Any metadata associated with the request (sources, etc) |
| outputs | Type: collection | The data outputs from the request. (see output fields for more detail) |
| utility_name | Type: string | The name of the utility company. If there are multiple utility companies serving the location, the names will be returned as a pipe-delimited string. |
| company_id | Type: integer | The ID of the utility company. If there are multiple utility companies serving the location, the IDs will be returned as a pipe-delimited string. |
| utility_info | Type: collection | An array of hashes containing the name(s) and ID(s) of the utility company or companies serving the location. |
| residential | Type: decimal | The residential electricity rate ($/kWh). |
| commercial | Type: decimal | The commercial electricity rate ($/kWh). |
| industrial | Type: decimal | The industrial electricity rate ($/kWh). |
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
format | string | The output response format. | |
lat | string | The latitude for the location to use. Required if address not given. | |
lon | string | The longitude for the location to use. Required if address not given. | |
address | null | Type: string | |
| Default: None | |||
| The address to use. Required if lat/lon not provided. | |||
radius | null | Type: decimal | |
| Default: 0 | |||
| Range: 0.0 to 200.0 | |||
| The radius (in miles) around the search location to search for utility rates with intersecting boundaries. |
With the default radius of 0, only utility rates whose boundaries contain the search location point will be returned. |
| limit | null | | Type: integer
Default: None
The maximum number of results to return. If no limit is specified then all matching results will be returned. |
RESPONSES
status: OK
{"inputs":{"lat":"40.730610","lon":"-73.935242"},"errors":[],"warnings":[],"version":"3.1.0","metadata":{"sources":["Ventyx Research (2012)"]},"outputs":{"company_id":"4226","utility_name":"Consolidated Edison Co of New York Inc","utility_info":[{"company_id":"4226","utility_name":"Consolidated Edison Co of New York Inc"}],"commercial":0.1155,"industrial":0.106,"residential":0.2321}}