Skip to main content
GET
/
applications
/
{application_id}
cURL
curl -X GET \
  "https://api.incentives.leap.energy/alpha/applications/123" \
  -H "x-api-key: leap_live_..." \
  -H "Content-Type: application/json"
{
  "id": 123,
  "program_id": 339,
  "customer_id": 609,
  "customer_device_id": [
    45,
    46
  ],
  "status": "in_progress",
  "rebate_type": "instant",
  "payee_type": "customer",
  "total_requested_amount": 150,
  "agree_terms": true,
  "customer_signature": true,
  "customer_sig_date": "2025-01-15",
  "project_name": "EV Charger Installation",
  "created_at": "2025-01-10T15:30:00Z",
  "updated_at": "2025-01-15T10:45:00Z",
  "customer": {
    "id": 609,
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "555-123-4567",
    "address_line1": "123 Peachtree St",
    "address_line2": "Apt 4B",
    "city": "Atlanta",
    "state": "GA",
    "zip_code": "30303",
    "eiaid": "14354",
    "utility_account_number": "ACC-123456789",
    "is_homeowner": true,
    "building_age_years": 25,
    "household_size": 4,
    "customer_devices": [
      {
        "id": 45,
        "customer_id": 609,
        "device_id": 240,
        "quantity": 1,
        "purchase_price": 599.99,
        "installation_cost": 450,
        "total_project_cost": 1049.99,
        "purchase_date": "2025-01-05",
        "installation_date": "2025-01-10",
        "contractor_name": "ABC Electric",
        "contractor_license": "EC-12345",
        "permits_obtained": true,
        "inspection_passed": true,
        "created_at": "2025-01-10T12:00:00Z",
        "updated_at": "2025-01-15T14:30:00Z",
        "device": {
          "model_name": "Smart Splitter",
          "manufacturer": "ChargePoint",
          "manufacture_year": 2024,
          "device_category_name": "EV Charger"
        }
      }
    ]
  }
}

​
Overview

Retrieve complete application details including all customer fields and customer devices.
Optional refId parameter: You can optionally include a refId query parameter to verify the application belongs to a specific customer within your organization.
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

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

Your unique identifier for the customer in your system. Must be unique per customer within your organization and matches the value you use with the incentives API.

Example:

"external-ref-123"

​
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