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"
import requests

url = "https://api.incentives.leap.energy/alpha/applications/123"
headers = {
"x-api-key": "leap_live_...",
"Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch(
'https://api.incentives.leap.energy/alpha/applications/123',
{
method: 'GET',
headers: {
'x-api-key': 'leap_live_...',
'Content-Type': 'application/json'
}
}
);

const data = await response.json();
console.log(data);
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.incentives.leap.energy/alpha/applications/{application_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.incentives.leap.energy/alpha/applications/{application_id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("x-api-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.incentives.leap.energy/alpha/applications/{application_id}")
.header("x-api-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.incentives.leap.energy/alpha/applications/{application_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "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"
        }
      }
    ]
  }
}
{
"code": "not_found",
"message": "Application 123 not found",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"details": "Additional context about the error"
}
{
"code": "forbidden",
"message": "Application not in your organization",
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
{
"code": "not_found",
"message": "Application 123 not found",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"details": "Additional context about the error"
}
{
"code": "not_found",
"message": "Application 123 not found",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"details": "Additional context about the error"
}

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