Changelog

API v1

API v1 is still under active development, but we are pleased to offer a new embeddable calculator widget for use now.

  • April 2, 2025: /api/v1/incentives: added new values of the items query parameter and response field: integrated_heat_pump_controls, solar_screen_films and electric_service_upgrades.

  • March 24, 2025: Multiple changes.

    • /api/v1/utilities: added two new top-level response fields, gas_utilities and gas_utility_affects_incentives.

    • /api/v1/incentives: added new values of the items query parameter and response field: cool_roof and solar_water_heater.

    • /api/v1/incentives: added a new optional query parameter, gas_utility.

    • /api/v1/incentives: added a new value of the authority_type field of incentives: gas_utility. This will only appear in responses if the new gas_utility parameter is passed, so although it is a new enum value, it does not break backward compatibility.

    • /api/v1/incentives: added a new optional field on incentives: paused.

    • /api/v1/incentives and /api/v1/utilities: the optional county subfield of the location field was removed, and an optional county_fips subfield was added instead.

  • Feburary 26, 2025: Our Program API is now available. All existing state coverage has been refreshed with 2025 data, and some incentives have been retired or updated for 2025. Indiana and New Mexico incentives are live, with additional New Mexico co-op data being added regularly. Hawaii, Iowa, Massachusetts, Minnesota, Missouri, New Jersey, Ohio, and Utah are now in beta and in active development and validation.

  • January 23, 2025: /api/v1/states removed from documentation. This endpoint is deprecated, and we will be removing it from the API in the near term.

    The endpoint's original purpose was to expose the status of data coverage in each state. However, we are no longer following a process of releasing all incentives in a state at once, so the endpoint no longer characterizes our coverage accurately.

    Instead, we populate incentive data incrementally for each state, and have front-loaded research to collect data about as many programs as we can. The data about programs will be available through /api/v1/programs as we roll it out.

  • April 3, 2024: A new version of our embeddable calculator is available which includes state and utility incentives for RI, DC, and VA.

    The new calculator is stable and actively used on our website as well as by partners like RI OER and Electrify DC.

API v0

API v0 was released in February 2023 as a direct clone of the original calculator logic on our website. It is now deprecated, and will be removed from the API in the near term.

  • January 23, 2025: removed from documentation.

  • June 11, 2024: deprecated.

  • August 22, 2023: added married_filing_separately as a valid value of tax_filing in requests, and of filing_status in responses.

    If you only use /api/v0/calculator, you are unaffected; you won't see the new value in responses unless you pass it in requests.

    If you use /api/v0/incentives, you'll see two new variations of the EV tax credits containing the new value.

    The current IRA incentives treat married-filing-separately filers the same as single filers. However, the tax brackets are slightly different, so the new value will result in more accurate calculations of tax savings.

Content

For changes to API content related to incentives, see the existing website changelog and related FAQs on the Rewiring America website.