Skip to main content
You can streamline the rebate application process by providing certain data directly, reducing the burden on end customers. This guide outlines common fields required across utilities.

How Claimed Fields Work

When you claim ownership of specific fields, those fields will be:
  • Removed from the customer-facing application form
  • Your responsibility to keep accurate and up-to-date
Start by claiming fields you already collect across all customers. You can expand to handle territory-specific data over time.
You don’t need to claim all fields in a category. Focus on what you can reliably provide with high accuracy. Start with HIGH frequency fields for maximum impact.

Customer Information

These fields contain basic information about the rebate applicant. Most partners can provide at least some of these fields from their customer management systems.
first_name
string
Frequency: HIGHThe first name of the customer
last_name
string
Frequency: HIGHThe last name of the customer
email
string
Frequency: HIGHThe email address of the customer
phone
string
Frequency: HIGHThe phone number of the customer
utility_account_number
string
Frequency: HIGHThe utility account number of the customer
address_line1
string
Frequency: HIGHThe first portion of the physical address of the customer
address_line2
string
Frequency: LOWThe second portion of the physical address of the customer
city
string
Frequency: HIGHThe city of the customer, found in their address
state
string
Frequency: MEDIUMThe state of the customer, found in their address
zip_code
string
Frequency: HIGHThe zip code of the customer, found in their address
mailing_address_line1
enum
Frequency: LOWStreet line of the customer’s mailing address (if different from service address)

Installation Details

These fields capture information about the equipment installation and purchase. Installation contractors and retailers are typically best positioned to provide this data.
is_homeowner
enum
Frequency: HIGHA boolean variable that defines whether the customer owns their home or not
device_serial
string
Frequency: HIGHSerial number of the newly installed device. Required for equipment registration, warranty tracking, and to prevent double-dipping on rebates.
quantity
integer
Frequency: LOWNumber of identical units installed at the same time. Default is 1. Used when multiple identical devices (like window AC units or smart thermostats) are installed in a single project.
purchase_date
date
Frequency: HIGHDate when the equipment was purchased. Must fall within program year dates and is used to verify eligibility timing requirements.
purchase_price
decimal
Frequency: MEDIUMThe retail price paid for the equipment only, excluding installation labor and materials. Used to verify rebates don’t exceed equipment cost and for calculating percentage-based incentives.
installation_date
date
Frequency: MEDIUMDate when the equipment was fully installed and operational. Critical for determining application deadlines (e.g., must apply within 30/60/90 days) and program year eligibility.
installation_cost
currency
Frequency: LOWThe cost of professional installation including labor, materials, permits, and any electrical/plumbing work. Separate from equipment cost to allow programs that reimburse installation separately.
trenching_required
enum
Frequency: LOWBoolean indicating if underground trenching was needed for installation. Relevant for EV chargers and can affect eligible installation costs.
permit_number
string
Frequency: MEDIUMThe building/electrical permit number issued by local authority. Required documentation for programs that mandate permits. Used for verification with local building departments.

Contractor Information

These fields identify and verify the installation contractor. General contractors and project managers typically have this information readily available.
contractor_name
string
Frequency: MEDIUMName of the company that performed the installation. Required by programs that mandate professional installation and used for contractor participation tracking.
contractor_license
string
Frequency: MEDIUMState license number of the installing contractor. Required to verify contractor is properly licensed per program requirements. Format varies by state.
contractor_contact_name
string
Frequency: MEDIUMName of the primary contact person at the contracting company. Used for direct communication about projects and applications.
contractor_contact_email
string
Frequency: MEDIUMEmail address for the primary contact at the contracting company. Used for program communications and missing documentation requests.
contractor_contact_phone
string
Frequency: LOWPhone number for the primary contact at the contracting company. Used for scheduling inspections and resolving application issues.
contractor_address_line1
string
Frequency: LOWStreet address of the contracting company. Required for vendor verification and 1099 tax reporting for incentive payments.
contractor_city
string
Frequency: LOWCity where the contracting company is located. Part of complete contractor address for business verification.
contractor_state
enum
Frequency: LOWState where the contracting company is located. Used to verify contractor is licensed in the state where work was performed.
contractor_zip
string
Frequency: LOWZIP code of the contracting company. Completes contractor address for correspondence and tax reporting.
contractor_website
string
Frequency: LOWWebsite URL of the contracting company. Used to verify contractor legitimacy and for customer reference.

Vehicle Information

These fields are specific to EV charger installations. Auto dealerships and EV charger installers working with vehicle information are best suited to provide this data.
vehicle_vin
string
Frequency: MEDIUMFor EV charger installations, the Vehicle Identification Number of the EV. Used to enforce one-rebate-per-vehicle rules and verify EV ownership.
vehicle_year
integer
Frequency: MEDIUMFor EV charger installations, the model year of the electric vehicle. Some programs have requirements about vehicle age.
vehicle_make
enum
Frequency: MEDIUMFor EV charger installations, the make of the electric vehicle (e.g., Tesla, Nissan, Chevrolet). Required to verify customer owns/leases an EV.
vehicle_model
string
Frequency: MEDIUMFor EV charger installations, the model of the electric vehicle (e.g., Model 3, Leaf, Bolt). Used with make to identify specific EV.
dealership
string
Frequency: LOWFor EV charger installations, name of dealership where vehicle was purchased/leased. Required documentation for some EV charger rebate programs.