HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Get Solar Incentives

Search for solar incentives and evaluate eligibility using location, customer, project, and applicability inputs.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Search for solar incentives and evaluate eligibility using location, customer, project, and applicability inputs.

Use this endpoint to retrieve incentives such as rebates, bill credits, tax credits, and discounts for a solar PV project. The response returns Incentive objects and sets each incentive's eligibility based on the filters and applicability values you provide.

triangle-exclamation

Solar incentive data requires special permissions and is available only under specific circumstances for Enterprise customers using Switch.

Resource URI

GET /rest/v1/incentives

Common query parameters

ParameterTypeDescription
projectTypeStringRestrict the search to the given project type, such as solarPv. Optional.
incentiveTypeStringRestrict the search to an incentive type, such as rebate, billCredit, taxCredit, or discount. Optional.
customerClassesStringCustomer class, such as RESIDENTIAL, GENERAL, or SPECIAL_USE. Optional.
countryCodeStringRestrict the search to a country. Optional.
stateStringRestrict the search to a state. Optional.
zipCodeStringRestrict the search to a ZIP code. Optional.
addressStringStringRestrict the search to an address. Optional.
lseIdIntegerRestrict the search to a load serving entity. Optional.
effectiveOnDateReturn incentives available as of this date. Optional.
fromDateDateReturn incentives available after this date. Optional.
toDateDateReturn incentives available before this date. Optional.
isExhaustedBooleanFilter incentives by whether funds are exhausted. Optional.
defaultIncentivesStringReturn incentives available to most people, based on default applicability values. Optional.

Applicability inputs

You can also pass arbitrary key=value applicability inputs, such as tilt=7 or azimuth=180. Applicability inputs do not filter incentives out of the response. Instead, they set each incentive's eligibility value to ELIGIBLE, INELIGIBLE, or COULD_BE_ELIGIBLE.

Use Get Incentive Applicabilities to discover which applicability keys may be required for a given market.

For the full incentive data model and detailed examples, see Solar Incentives.

Example

GET /rest/v1/incentives?zipCode=95448&projectType=solarPv&customerClasses=RESIDENTIAL&effectiveOn=2015-11-05&isExhausted=false

A successful response returns a standard response payload with type set to Incentive and results containing matching solar incentives.

Query Params
string

Restrict the search to the given project type

string

Restrict the search to the given incentive type

string

Return the incentives that are available to most people, where “most people” is defined as those incentives that match the defaults for their respective applicabilities

string

Get incentives accepts an arbitrary list of key=value pairs representing inputs for the different applicability keys. Inputs do not cause the list of incentives to be filtered, but the eligibility status for each incentive is set depending on the applicability key values. For example, if a user inputs ?tilt=7&azimuth=180, then incentives that require a system with a tilt of 7 degrees and an azimuth of 180 degrees will be set to ELIGIBLE if those are the only applicabilities. If additional applicabilities exist, depending on key values, eligibility may also be INELIGIBLE or COULD_BE_ELIGIBLE. Available applicabilities for a given area are returned by Get Incentive Applicabilities.

string

RESIDENTIAL, GENERAL, or SPECIAL_USE. The type of customer

string

Restrict the search to the given country

int32

Restrict the search to the given LSE

string

Restrict the search to the given state

string

Restrict the search to the given ZIP code

string

Restrict the search to the given addressString

date

Get only those incentives that are available as of the specified date.

date

Get incentives that are available after a certain date.

date

Get incentives that are available before a certain date.

boolean

Get incentives that are exhausted (or not)

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json