Utility
Query utilities
Base URL
GET /api/v2/utilities.json
URL Parameters
| Name | Description |
|---|---|
| state_abbv | Two letter state code |
| zip | Zipcode |
| name | Utility name |
If you specify more than one type of search query, only the most specific will be used.
The order from least to most specific is state_abbr, zip, name.
Example /api/v2/utilities.json?state_abbv=PA&zip=15213 will return only the utilities in the zip code 15213.
If you specify wrong combination of a search query, empty array will be returned.
Example /api/v2/utilities.json?state_abbv=PA&zip=43200
Example
GET /api/v2/utilities.json?state_abbv=PA
GET /api/v2/utilities.json?zip=15213
GET /api/v2/utilities.json?name=Duquesne%20Light%20Co
Returns
status and measurements are only available if zip is present
[
{
"name": Utility Name,
"state": "XX",
"eiacode": "XXXXX",
"status": "Open" | "Closed" | "Partial" | "Not Currently Accepting Applications" |
"Waitlist" | "Funds Low" | "In Transition" | "Preview",
"measurements": Technologies Supported By Utility Program
},
...
]
Retrieve program status information
Base URL
GET /api/v2/utilities/program_status.json
URL Parameters
| Name | Description |
|---|---|
| state_abbv | Two letter state code |
| eiacode | 5 digit EIA number for utility operating company |
Example
GET /api/v2/utilities/program_status.json?state_abbv=AL
GET /api/v2/utilities/program_status.json?state_abbv=AL&eiacode=00241
Returns
[
{
"utility": Utility Name ,
"eiacode": "00241",
"state": "AL",
"status": "Open" | "Closed" | "Partial" | "Not Currently Accepting Applications" |
"Waitlist" | "Funds Low" | "In Transition" | "Preview" ,
"pre_approval": "Yes" | "No",
"pre_inspection": "Yes" | "No",
"post_inspection": "Yes" | "No",
"pre_approved_contractor": "Yes" | "No",
"rebate_cap": Cap Information ,
"max_payout_per_period": "$100,000",
"app_submitter": "Anyone" | "Owner" | "Registered",
"eligibility": Eligibility Information,
"measurements": Technologies Supported By Utility Program
},
...
]
Retrieve building types for utility
Base URL
GET /api/v2/utilities/building_types.json
URL Parameters
| Name | Description |
|---|---|
| state_abbv | Two letter state code |
| eiacode | 5 digit EIA number for utility operating company |
Example
GET /api/v2/utilities/building_types.json?state_abbv=PA&eiacode=05487
Returns
[
{
"id" : Building Type ID,
"abbr": Building Type Abbr,
"category": Apply To This Product Category
"cf" : Control Factor,
"hou": Building Hours,
"name": Building Type Name
},
...
]