Skip to main content
GET
cURL

Authorizations

x-api-key
string
header
required

Your Leap API key. Send it in the x-api-key header: x-api-key: leap_live_....

Path Parameters

application_id
integer
required

Unique identifier for the application

Example:

123

Query Parameters

refId
string

Reference ID to verify the application belongs to a specific customer within your organization

Example:

"982734ihksjhfwoe8u"

Response

Successfully retrieved application

Complete application with nested customer and device information

id
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_customer,
awaiting_partner,
completed,
submitted,
approved,
rejected
Example:

"in_progress"

reference_id
string | null

Reference ID for the customer within the organization (from customer_organizations). Matches the reference_id used with the incentives API.

Example:

"external-ref-123"

customer_device_id
integer[]

Array of customer device IDs associated with this application

Example:
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. Equal to the sum of upfront_amount + install_amount + ongoing_amount.

Example:

150

upfront_amount
number<decimal> | null

Pre-install upfront incentive amount. Reserved for future use; currently always 0. Part of the itemized breakdown that sums to total_requested_amount.

Example:

0

install_amount
number<decimal> | null

At-install one-time incentive amount. Part of the itemized breakdown that sums to total_requested_amount.

Example:

150

ongoing_amount
number<decimal> | null

Ongoing incentive amount, per year. Part of the itemized breakdown that sums to total_requested_amount.

Example:

0

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 | null

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