Developer Network NREL NREL Developer Network

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.
Help Improve this Content