Skip to main content
GET
/
applications
cURL
curl -X GET \
  "https://api.incentives.leap.energy/alpha/applications?application_status=awaiting_partner&limit=50" \
  -H "x-api-key: leap_live_..." \
  -H "Content-Type: application/json"
import requests

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

response = requests.get(url, params=params, headers=headers)
print(response.json())
const response = await fetch(
'https://api.incentives.leap.energy/alpha/applications?application_status=awaiting_partner&limit=50',
{
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",
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"

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")
.header("x-api-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

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

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
{
  "next_page_token": "242c3e24-43e6-4ad7-88b3-666cda21582b",
  "results": [
    {
      "id": 123,
      "program_id": 339,
      "customer_id": 609,
      "customer_device_id": [
        45,
        46
      ],
      "status": "awaiting_partner",
      "rebate_type": "instant",
      "payee_type": "customer",
      "total_requested_amount": 150,
      "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",
        "city": "Atlanta",
        "state": "GA",
        "zip_code": "30303"
      }
    }
  ]
}
{
"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"
}
{
"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"
}

Overview

Search and filter applications with pagination.
Truncated Response: The search endpoint returns a simplified version of application data. For complete application details including all customer fields and customer devices, use the Get Application endpoint.
For more information and best practices, 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_...

Query Parameters

refId
string

Reference ID to filter applications for a specific customer within your organization

Example:

"982734ihksjhfwoe8u"

application_status
enum<string>

Filter by application status

Available options:
not_started,
in_progress,
awaiting_customer,
awaiting_partner,
completed,
submitted,
approved,
rejected
Example:

"awaiting_partner"

page_token
string

Token for pagination to fetch the next page of results

Example:

"242c3e24-43e6-4ad7-88b3-666cda21582b"

limit
integer
default:50

Maximum number of results to return per page

Required range: 1 <= x <= 100
Example:

50

Response

Successful response with list of applications

results
object[]
required

Array of applications matching the search criteria

next_page_token
string | null

Token to fetch the next page of results. Null if no more pages available.

Example:

"242c3e24-43e6-4ad7-88b3-666cda21582b"