Get Application

Overview

Retrieve complete application details including all customer fields and customer devices. For searching multiple applications, use the Search Applications endpoint. For more information, see the Applications API Guide.

Authorizations

x-api-key

string

header

required

API key for authentication. Include your Leap API key in the x-api-key header: x-api-key: leap_live_...

Path Parameters

application_id

integer

required

Unique identifier for the application

Example:

123

Response

Successfully retrieved application

Complete application with nested customer and device information

integer

required

Unique identifier for the application

Example:

123

program_id

integer

required

ID of the rebate program this application is for

Example:

339

customer_id

integer

required

ID of the customer who owns this application

Example:

609

status

enum<string>

default:not_started

required

Current status of the application

Available options:

not_started,

in_progress,

awaiting_partner,

completed,

submitted,

approved,

rejected

Example:

"in_progress"

customer_device_id

integer[]

Array of customer device IDs associated with this application

Example:

[45, 46]

rebate_type

string | null

Type of rebate being requested

Example:

"instant"

payee_type

enum<string> | null

Who will receive the rebate payment

Available options:

customer,

contractor,

instant

Example:

"customer"

submission_date

string<date> | null

Date the application was submitted

Example:

"2025-01-15"

approval_date

string<date> | null

Date the application was approved

Example:

"2025-01-20"

total_requested_amount

number<decimal> | null

Total rebate amount being requested

Example:

150

recaptcha_token

string | null

reCAPTCHA token for bot prevention

agree_terms

boolean | null

Whether customer agreed to terms and conditions

Example:

true

customer_signature

boolean | null

Whether customer has signed the application

Example:

true

customer_sig_date

string<date> | null

Date of customer signature

Example:

"2025-01-15"

contractor_signature

boolean | null

Whether contractor has signed the application

Example:

false

contractor_sig_date

string<date> | null

Date of contractor signature

project_name

string | null

Name/description of the project

Maximum string length: 255

Example:

"EV Charger Installation"

eligibility_category

enum<string> | null

Eligibility category for tiered programs

Available options:

1A,

1B,

1C,

2

income_backup_onfile

boolean

default:false

Whether income verification documentation is on file

neat_sir_verified

boolean | null

Whether NEAT/SIR verification is complete

proposed_measures

object

JSONB object containing proposed energy efficiency measures

prepay_amount

number<decimal> | null

Amount to be prepaid to contractor

authorize_contractor

boolean

default:false

Authorization to pay contractor directly

authorize_payee

boolean

default:false

Authorization to pay specified payee

utility_account_attestation

boolean | null

Attestation that applicant is utility account holder

equipment_complete

boolean | null

Whether all equipment documentation is complete

permit_complete

boolean | null

Whether all permit documentation is complete

utility_complete

boolean | null

Whether all utility documentation is complete

created_at

string<date-time>

Timestamp when application was created

Example:

"2025-01-10T15:30:00Z"

updated_at

string<date-time>

Timestamp when application was last updated

Example:

"2025-01-15T10:45:00Z"

customer

object

Customer information associated with an application

Show child attributes

customer.id

integer

required

Unique identifier for the customer

Example:

609

customer.address_line1

string

required

Street address line 1

Example:

"123 Peachtree St"

customer.city

string

required

City

Example:

"Atlanta"

customer.state

string

required

State code (2 letters)

Example:

"GA"

customer.zip_code

string

required

ZIP code

Example:

"30303"

customer.first_name

string | null

Customer's first name

Example:

"John"

customer.last_name

string | null

Customer's last name

Example:

"Doe"

customer.email

string<email> | null

Customer's email address

Example:

"[email protected]"

customer.phone

string | null

Customer's phone number

Example:

"555-123-4567"

customer.address_line2

string | null

Street address line 2 (apt, suite, etc.)

Example:

"Apt 4B"

customer.eiaid

string | null

Energy Information Administration utility ID

Example:

"14354"

customer.utility_account_number

string | null

Customer's utility account number

Example:

"ACC-123456789"

customer.building_type_id

integer | null

ID of the building type

Example:

1

customer.is_homeowner

boolean

default:false

Whether customer owns the property

Example:

true

customer.is_income_qualified

boolean

default:false

Whether customer qualifies for income-based programs

Example:

false

customer.building_age_years

integer | null

Age of the building in years

Example:

25

customer.within_city_limits

boolean | null

Whether property is within city limits

Example:

true

customer.referral_source

string | null

How customer heard about the program

Maximum string length: 255

Example:

"utility website"

customer.fax

string | null

Customer's fax number

customer.conditioned_sqft

integer | null

Square footage of conditioned space

Example:

2000

customer.gut_rehab

boolean

default:false

Whether property is undergoing gut rehabilitation

customer.gas_appliance_present

boolean

default:false

Whether gas appliances are present

customer.home_energy_assessment_completed

boolean

default:false

Whether a home energy assessment has been completed

customer.household_size

integer | null

Number of people in household

Example:

4

customer.mailing_address_line1

string | null

Mailing address if different from property address

customer.mailing_city

string | null

Mailing address city

customer.mailing_state

string | null

Mailing address state

customer.mailing_zip

string | null

Mailing address ZIP code

customer.alt_phone

string | null

Alternate phone number

customer.biz_tax_status

string | null

Business tax status

customer.ca_entity_id

string | null

California entity ID

customer.county_parish

string | null

County or parish name

Example:

"Fulton County"

customer.is_indigenous

boolean

default:false

Whether customer identifies as indigenous

customer.is_veteran

boolean

default:false

Whether customer is a veteran

customer.is_senior

boolean

default:false

Whether customer is a senior

customer.is_first_responder

boolean

default:false

Whether customer is a first responder

customer.property_details

object

Additional property details as JSONB

customer.utility_rate_plan

string | null

Customer's utility rate plan

Example:

"R-1B"

customer.utility_account_status

enum<string>

default:active

Status of utility account

Available options:

active,

inactive,

pending

customer.dwelling_units

integer | null

Number of dwelling units in building

Example:

1

customer.is_test

boolean

default:false

Whether this is a test customer record

customer.customer_devices

object[]

Array of devices associated with this customer

Show child attributes

customer.customer_devices.id

integer

required

Unique identifier for this customer device record

Example:

45

customer.customer_devices.customer_id

integer

required

ID of the customer who owns this device

Example:

609

customer.customer_devices.device_id

integer | null

ID of the device from the devices catalog

Example:

240

customer.customer_devices.quantity

integer

default:1

Number of devices purchased

Example:

1

customer.customer_devices.purchase_price

number<decimal> | null

Price paid for the device

Example:

599.99

customer.customer_devices.installation_cost

number<decimal> | null

Cost of installation

Example:

450

customer.customer_devices.total_project_cost

number<decimal> | null

Total cost including equipment and installation

Example:

1049.99

customer.customer_devices.purchase_date

string<date> | null

Date device was purchased

Example:

"2025-01-05"

customer.customer_devices.installation_date

string<date> | null

Date device was installed

Example:

"2025-01-10"

customer.customer_devices.existing_equipment_age_years

integer | null

Age of equipment being replaced

Example:

15

customer.customer_devices.existing_equipment_operational

boolean | null

Whether existing equipment is still operational

Example:

false

customer.customer_devices.existing_equipment_manufacturer

string | null

Manufacturer of existing equipment

Maximum string length: 100

Example:

"Old Brand"

customer.customer_devices.existing_equipment_model

string | null

Model of existing equipment

Maximum string length: 100

Example:

"Model-X"

customer.customer_devices.installation_location

string | null

Where device was installed

Maximum string length: 100

Example:

"Garage"

customer.customer_devices.contractor_name

string | null

Name of contractor who performed installation

Maximum string length: 200

Example:

"ABC Electric"

customer.customer_devices.contractor_license

string | null

Contractor's license number

Maximum string length: 100

Example:

"EC-12345"

customer.customer_devices.permits_obtained

boolean

default:false

Whether required permits were obtained

Example:

true

customer.customer_devices.inspection_passed

boolean

default:false

Whether inspection passed

Example:

true

customer.customer_devices.application_submitted_date

string<date> | null

Date application was submitted

Example:

"2025-01-15"

customer.customer_devices.permit_number

string | null

Permit number

Example:

"PMT-2025-001"

customer.customer_devices.vehicle_make

string | null

Make of vehicle (for EV chargers)

Example:

"Tesla"

customer.customer_devices.vehicle_model

string | null

Model of vehicle (for EV chargers)

Example:

"Model 3"

customer.customer_devices.vehicle_year

integer | null

Year of vehicle (for EV chargers)

Example:

2023

customer.customer_devices.vehicle_vin

string | null

Vehicle identification number

Example:

"5YJ3E1EA9KF123456"

customer.customer_devices.dealership

string | null

Dealership where vehicle was purchased

Example:

"Tesla Atlanta"

customer.customer_devices.contractor_contact_email

string<email> | null

Contractor's email

Example:

"[email protected]"

customer.customer_devices.contractor_contact_phone

string | null

Contractor's phone number

Example:

"555-987-6543"

customer.customer_devices.contractor_website

string<uri> | null

Contractor's website

Example:

"https://www.abcelectric.com"

customer.customer_devices.trenching_required

boolean | null

Whether trenching was required for installation

Example:

false

customer.customer_devices.contractor_contact_name

string | null

Name of contractor contact person

Maximum string length: 255

Example:

"Jane Smith"

customer.customer_devices.contractor_address_line1

string | null

Contractor's street address

Maximum string length: 255

Example:

"789 Business Blvd"

customer.customer_devices.contractor_city

string | null

Contractor's city

Maximum string length: 255

Example:

"Atlanta"

customer.customer_devices.contractor_state

string | null

Contractor's state

Maximum string length: 255

Example:

"GA"

customer.customer_devices.contractor_zip

string | null

Contractor's ZIP code

Maximum string length: 20

Example:

"30301"

customer.customer_devices.existing_equipment_photos_provided

boolean | null

Whether photos of existing equipment were provided

customer.customer_devices.existing_equipment_serial

string | null

Serial number of existing equipment

Maximum string length: 255

customer.customer_devices.existing_heating_type

string | null

Type of existing heating system

Maximum string length: 255

Example:

"Gas furnace"

customer.customer_devices.device_serial

string | null

Serial number of new device

Maximum string length: 255

Example:

"SN-123456789"

customer.customer_devices.louvered_sides

boolean | null

Whether device has louvered sides

customer.customer_devices.contractor_fax

string | null

Contractor's fax number

customer.customer_devices.coil_make_model

string | null

Make and model of coil (for HVAC)

customer.customer_devices.created_at

string<date-time>

Timestamp when record was created

Example:

"2025-01-10T12:00:00Z"

customer.customer_devices.updated_at

string<date-time>

Timestamp when record was last updated

Example:

"2025-01-15T14:30:00Z"

Getting Started

API Reference

Guides

Overview

Authorizations

Path Parameters

Response

Getting Started

API Reference

Guides

​Overview

Authorizations

Path Parameters

Response

Overview