Energy Incentives (Version 1 - Deprecated) (GET /api/energy-incentives/v1)
Deprecated: We encourage you to migrate to version 2 of the utility rates API.
This service lists the incentives found in the DSIRE quantitative spreadsheet by location.
The DSIRE database, which is managed by the the North Carolina Solar Center and provides the quantitative data that support this web service, is undergoing substantial changes with their new contract with DOE. This transition will involve a significant gap in the provision of the quantitative data that support this web service. As a result of this, the data available in this web service will not be updated between Sept 1st and June 30th. The service will remain active to ensure that the best available data remains accessible.
Announcement from DSIRE: The U.S. Department of Energy and the North Carolina Solar Center are excited to announce that a new, modernized DSIRE is under construction. The new version of DSIRE will offer significant improvements over the current version, including expanded data accessibility and an array of new tools for site users. The new DSIRE site will be available in the summer of 2014. Staff are currently working hard on the new DSIRE and are unfortunately only able to make minimal updates to the DSIRE website at this time. We apologize for any inconvenience and thank you for using DSIRE.
Request URL
GET /api/energy-incentives/v1.format?parameters
Request Parameters
| Parameter | Required | Value | Description | |||
|---|---|---|---|---|---|---|
| api_key | Yes |
Type: string
Default: None
|
Your developer API key. See API keys for more information. |
|||
| address | Depends |
Type: string
Default: None
|
The address to use (lat/lon returned by Google's geocoding service). Required if lat/lon not provided. |
|||
| lat | Depends |
Type: decimal
Default: None
Range: -90 to 90
|
The latitude for the location to use. Required if address not given. | |||
| lon | Depends |
Type: decimal
Default: None
Range: -180 to 180
|
The longitude for the location to use. Required if address not given. | |||
| incentive_types | No |
Type: comma delimited string
Default: None
Options: ad_incentives,
biomass_incentives, csp_incentives, lfg_incentives, pool_incentives, solar_incentives, ssh_incentives, swh_incentives, wind_incentives, wte_incentives, |
The type of incentive to return. Will return all incentive types if no parameter is provided. |
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. |
| infos | Type: array of strings | Any info 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 the DSIRE website for more detail) |
Examples
JSON Output Format
GET /api/energy-incentives/v1.json?api_key=DEMO_KEY&lat=40&lon=-105&incentive_types=ad_incentives,csp_incentives
{
"version": "1.0.1",
"metadata": {
"sources": [
"Ventyx Research (2011)",
"EIA (2011)"
]
},
"inputs": {
"api_key": "DEMO_KEY",
"lat": "40",
"lon": "-105",
"incentive_types": [
"ad_incentives",
"csp_incentives"
]
},
"infos": [
],
"errors": [
],
"warnings": [
],
"outputs": {
"ad_incentives": [
{
"dsire_id": "US13F",
"gid": 123,
"incentive_code": "US13F",
"memo": "03/07/11 revised history section to show 3 PTC expirations (1999 one was missing). JB 12/3/10 Added to note info about grant expiration on 12/31/10. AH 07/19/10 fixed incentive amount field, 2.1 cents to 2.2 cents, missed this hen I did the update. 06/09/10 removed ADG from eligible list, pending conv. with IRS abou...",
"notes": "The electricity must be sold by the taxpayer to an unrelated person during the taxable year. The American Recovery and Reinvestment Act of 2009 allows taxpayers eligible for the federal renewable electricity production tax credit (PTC) to take the federal business energy investment tax credit (ITC) instead of taking the PTC for new installations. Credit level listed here is for 2013.",
"program_name": "Renewable Electricity Production Tax Credit (PTC)",
"sector": "F",
"state": "Federal",
"anaerobic_digestion_com_ptc_dlrs_kwh": 0.011,
"anaerobic_digestion_ptc_duration_years": 10.0
}
],
"csp_incentives": [
{
"dsire_id": "US02F",
"gid": 122,
"incentive_code": "US02F",
"memo": "12/20/10 Changed reference to grant expiration to 12/31/11 BL 12/3/10 Added to note info about grant expiration date of 12/31/10. AH 6/9/10 Reviewed statute -- no substantive changes. Removed history section: The federal Energy Policy Act of 2005 (EPAct 2005) expanded the existing federal business energy tax c...",
"notes": "The American Recovery and Reinvestment Act of 2009 allows taxpayers eligible for the federal renewable electricity production tax credit (PTC) to take the federal business energy investment tax credit (ITC) instead of taking the PTC for new installations.",
"program_name": "Business Energy Investment Tax Credit (ITC)",
"sector": "F",
"state": "Federal",
"csp_com_tax_credit_pcnt_cost": 0.3
}
],
"utility_name": "United Power Inc",
"utility_id": "63360",
"utility_info": [
{
"company_id": "63360",
"utility_name": "United Power Inc"
}
],
"lat": 40.0,
"lon": -105.0,
"city": "Broomfield",
"state": "CO",
"zip": "80023"
}
}
XML Output Format
GET /api/energy-incentives/v1.xml?api_key=DEMO_KEY&lat=40&lon=-105&incentive_types=ad_incentives,csp_incentives
<?xml version="1.0" encoding="UTF-8"?>
<incentives>
<version>1.0.1</version>
<metadata>
<sources type="array">
<source>Ventyx Research (2011)</source>
<source>EIA (2011)</source>
</sources>
</metadata>
<inputs>
<api-key>DEMO_KEY</api-key>
<lat>40</lat>
<lon>-105</lon>
<incentive-types type="array">
<incentive-type>ad_incentives</incentive-type>
<incentive-type>csp_incentives</incentive-type>
</incentive-types>
</inputs>
<infos type="array"/>
<errors type="array"/>
<warnings type="array"/>
<outputs>
<ad-incentives type="array">
<ad-incentive>
<dsire-id>US13F</dsire-id>
<gid type="integer">123</gid>
<incentive-code>US13F</incentive-code>
<memo>03/07/11 revised history section to show 3 PTC expirations (1999 one was missing). JB 12/3/10 Added to note info about grant expiration on 12/31/10. AH 07/19/10 fixed incentive amount field, 2.1 cents to 2.2 cents, missed this hen I did the update. 06/09/10 removed ADG from eligible list, pending conv. with IRS abou...</memo>
<notes>The electricity must be sold by the taxpayer to an unrelated person during the taxable year. The American Recovery and Reinvestment Act of 2009 allows taxpayers eligible for the federal renewable electricity production tax credit (PTC) to take the federal business energy investment tax credit (ITC) instead of taking the PTC for new installations. Credit level listed here is for 2013.</notes>
<program-name>Renewable Electricity Production Tax Credit (PTC)</program-name>
<sector>F</sector>
<state>Federal</state>
<dsire-id>US13F</dsire-id>
<anaerobic-digestion-com-ptc-dlrs-kwh type="float">0.011</anaerobic-digestion-com-ptc-dlrs-kwh>
<anaerobic-digestion-ptc-duration-years type="float">10.0</anaerobic-digestion-ptc-duration-years>
</ad-incentive>
</ad-incentives>
<csp-incentives type="array">
<csp-incentive>
<dsire-id>US02F</dsire-id>
<gid type="integer">122</gid>
<incentive-code>US02F</incentive-code>
<memo>12/20/10 Changed reference to grant expiration to 12/31/11 BL 12/3/10 Added to note info about grant expiration date of 12/31/10. AH 6/9/10 Reviewed statute -- no substantive changes. Removed history section: The federal Energy Policy Act of 2005 (EPAct 2005) expanded the existing federal business energy tax c...</memo>
<notes>The American Recovery and Reinvestment Act of 2009 allows taxpayers eligible for the federal renewable electricity production tax credit (PTC) to take the federal business energy investment tax credit (ITC) instead of taking the PTC for new installations.</notes>
<program-name>Business Energy Investment Tax Credit (ITC)</program-name>
<sector>F</sector>
<state>Federal</state>
<dsire-id>US02F</dsire-id>
<csp-com-tax-credit-pcnt-cost type="float">0.3</csp-com-tax-credit-pcnt-cost>
</csp-incentive>
</csp-incentives>
<utility-name>United Power Inc</utility-name>
<utility-id>63360</utility-id>
<utility-info type="array">
<utility-info>
<company-id>63360</company-id>
<utility-name>United Power Inc</utility-name>
</utility-info>
</utility-info>
<lat type="float">40.0</lat>
<lon type="float">-105.0</lon>
<city>Broomfield</city>
<state>CO</state>
<zip>80023</zip>
</outputs>
</incentives>
Rate Limits
Standard rate limits apply. No more than 1,000 requests may be made in any hour
Errors
Standard errors may be returned. In addition, the following service-specific errors may be returned:
| HTTP Status Code | Description |
|---|---|
| 422 | Unprocessable Entity - One or more parameters did not pass validation, or a parameter may be missing. Check the error section of the response to see how the request url should be modified to address the error. |