API DocumentationAPI Documentation
The Rewiring America API

Incentives

Endpoint:https://api.rewiringamerica.org

Find eligible incentives

GET
https://api.rewiringamerica.org
/api/v1/calculator

Find eligible incentives › query Parameters

  • owner_statusstring · enum · required
    Enum values:
    homeowner
    renter
  • household_incomeinteger · max: 100000000 · required
  • household_sizeinteger · min: 1 · max: 8 · required
  • zipstring · minLength: 5 · maxLength: 5
  • addressstring
  • authority_typesstring[] · minItems: 1 · unique
    Enum values:
    federal
    city
    county
    state
    utility
    gas_utility
    other
  • utilitystring
  • gas_utilitystring
  • itemsstring[] · minItems: 1 · unique
    Enum values:
    air_sealing
    air_to_water_heat_pump
    attic_or_roof_insulation
    basement_insulation
    battery_storage_installation
    central_air_conditioner
    cool_roof
    crawlspace_insulation
  • tax_filingstring · enum
    Enum values:
    hoh
    joint
    married_filing_separately
    single
    qualifying_widower_with_dependent_child
  • languagestring · enum
    Enum values:
    en
    es
    Default: en
  • include_beta_statesboolean
    Default: false

Find eligible incentives › Headers

  • Authorizationstring · required

Find eligible incentives › Responses

  • is_under_80_amiboolean · required
  • is_under_150_amiboolean · required
  • is_over_150_amiboolean · required
  • authoritiesobject · required
  • coverageobject · required
  • locationobject · required
  • incentivesobject[] · required
  • data_partnersobject

Find utilities by location

GET
https://api.rewiringamerica.org
/api/v1/utilities

Find utilities by location › query Parameters

  • zipstring · minLength: 5 · maxLength: 5
  • addressstring
  • languagestring · enum
    Enum values:
    en
    es
    Default: en

Find utilities by location › Headers

  • Authorizationstring · required

Find utilities by location › Responses

  • locationobject · required
  • utilitiesobject · required
  • gas_utilitiesobject
  • gas_utility_affects_incentivesboolean

Get all programs by location

GET
https://api.rewiringamerica.org
/api/v1/incentives/programs

Get all programs by location › query Parameters

  • zipstring · minLength: 5 · maxLength: 5
  • addressstring
  • authority_typesstring[] · minItems: 1 · unique
    Enum values:
    federal
    city
    county
    state
    utility
    gas_utility
    other
  • utilitystring
  • gas_utilitystring
  • languagestring · enum
    Enum values:
    en
    es
    Default: en

Get all programs by location › Headers

  • Authorizationstring · required

Get all programs by location › Responses

  • authoritiesobject · required
  • coverageobject · required
  • locationobject · required
  • programsobject · required
Residential Electrification Model