curl -X PATCH \
"https://api.incentives.leap.energy/alpha/applications/123" \
-H "x-api-key: leap_live_..." \
-H "Content-Type: application/json" \
-d '{
"approval_date": "2025-01-25",
"customer": {
"email": "[email protected]"
}
}'{
"ok": true,
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"application_id": 123,
"customer_id": 456,
"mutations": {
"application": {
"updated": true,
"fields": [
"status",
"approval_date"
]
},
"customer": {
"updated": true,
"fields": [
"email"
]
}
},
"data": {
"id": 123,
"program_id": 45,
"customer_id": 456,
"organization_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "approved",
"approval_date": "2025-01-25",
"submission_date": "2025-01-15",
"created_at": "2025-01-10T10:00:00Z",
"updated_at": "2025-01-25T16:45:00Z",
"customer": {
"id": 456,
"first_name": "Jane",
"last_name": "Doe",
"email": "[email protected]",
"customer_devices": [
{
"id": 10,
"customer_id": 456,
"device_id": 5,
"quantity": 1
}
]
}
}
}Update Application
Update an application by application ID. Supports updating application fields, customer information, and customer devices.
curl -X PATCH \
"https://api.incentives.leap.energy/alpha/applications/123" \
-H "x-api-key: leap_live_..." \
-H "Content-Type: application/json" \
-d '{
"approval_date": "2025-01-25",
"customer": {
"email": "[email protected]"
}
}'{
"ok": true,
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"application_id": 123,
"customer_id": 456,
"mutations": {
"application": {
"updated": true,
"fields": [
"status",
"approval_date"
]
},
"customer": {
"updated": true,
"fields": [
"email"
]
}
},
"data": {
"id": 123,
"program_id": 45,
"customer_id": 456,
"organization_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "approved",
"approval_date": "2025-01-25",
"submission_date": "2025-01-15",
"created_at": "2025-01-10T10:00:00Z",
"updated_at": "2025-01-25T16:45:00Z",
"customer": {
"id": 456,
"first_name": "Jane",
"last_name": "Doe",
"email": "[email protected]",
"customer_devices": [
{
"id": 10,
"customer_id": 456,
"device_id": 5,
"quantity": 1
}
]
}
}
}Overview
Update application fields, customer information, and customer devices. UsedryRun=true as a query parameter to validate the request without applying changes.
customer_devices must include id (required, not optional). Missing id will return a 400 Bad Request error.Authorizations
API key for authentication. Include your Leap API key in the x-api-key header: x-api-key: leap_live_...
Path Parameters
Application ID to update. The application must belong to your organization.
Query Parameters
If true, validates the request without applying changes
false
Body
Application update request. See schema for details.
Request body for updating an application by application ID (organization authentication).
Matches GET /applications/{id} response structure without protected fields.
All fields are optional - only include fields you want to modify.
Protected fields (cannot be updated): id, customer_id, organization_id, program_id, status, created_at, updated_at
Type of rebate being requested
Who will receive the rebate payment
customer, contractor, instant Date the application was submitted
"2025-01-20"
Date the application was approved
"2025-01-25"
Total rebate amount being requested
Whether equipment documentation is complete
Whether permit documentation is complete
Whether utility documentation is complete
Array of customer device IDs associated with this application
Customer fields to update (optional)
Show child attributes
Show child attributes
255active, inactive, pending Array of customer devices to update or create.
Include id to update existing device, omit id to create new device.
Show child attributes
Show child attributes
ID of existing customer device (required)
78
10010010020010025525525525520255255255Array of customer devices to update. Each device must include 'id' to identify the device.
Show child attributes
Show child attributes
ID of existing customer device (required)
78
10010010020010025525525525520255255255Response
Successfully updated application(s)
true
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
123
456
Details about what was updated
Show child attributes
Show child attributes
Complete snapshot matching GET /applications/{id} response structure
Complete application with nested customer and device information
Show child attributes
Show child attributes
Unique identifier for the application
123
ID of the rebate program this application is for
339
ID of the customer who owns this application
609
Current status of the application
not_started, in_progress, awaiting_partner, completed, submitted, approved, rejected "in_progress"
Array of customer device IDs associated with this application
[45, 46]Type of rebate being requested
"instant"
Who will receive the rebate payment
customer, contractor, instant "customer"
Date the application was submitted
"2025-01-15"
Date the application was approved
"2025-01-20"
Total rebate amount being requested
150
reCAPTCHA token for bot prevention
Whether customer agreed to terms and conditions
true
Whether customer has signed the application
true
Date of customer signature
"2025-01-15"
Whether contractor has signed the application
false
Date of contractor signature
Name/description of the project
255"EV Charger Installation"
Eligibility category for tiered programs
1A, 1B, 1C, 2 Whether income verification documentation is on file
Whether NEAT/SIR verification is complete
JSONB object containing proposed energy efficiency measures
Amount to be prepaid to contractor
Authorization to pay contractor directly
Authorization to pay specified payee
Attestation that applicant is utility account holder
Whether all equipment documentation is complete
Whether all permit documentation is complete
Whether all utility documentation is complete
Timestamp when application was created
"2025-01-10T15:30:00Z"
Timestamp when application was last updated
"2025-01-15T10:45:00Z"
Customer information associated with an application Customer information associated with an application
Show child attributes
Show child attributes
Unique identifier for the customer Unique identifier for the customer
609
Street address line 1 Street address line 1
"123 Peachtree St"
City City
"Atlanta"
State code (2 letters) State code (2 letters)
"GA"
ZIP code ZIP code
"30303"
Customer's first name Customer's first name
"John"
Customer's last name Customer's last name
"Doe"
Customer's email address Customer's email address
Customer's phone number Customer's phone number
"555-123-4567"
Street address line 2 (apt, suite, etc.) Street address line 2 (apt, suite, etc.)
"Apt 4B"
Energy Information Administration utility ID Energy Information Administration utility ID
"14354"
Customer's utility account number Customer's utility account number
"ACC-123456789"
ID of the building type ID of the building type
1
Whether customer owns the property Whether customer owns the property
true
Whether customer qualifies for income-based programs Whether customer qualifies for income-based programs
false
Age of the building in years Age of the building in years
25
Whether property is within city limits Whether property is within city limits
true
How customer heard about the program How customer heard about the program
255"utility website"
Customer's fax number Customer's fax number
Square footage of conditioned space Square footage of conditioned space
2000
Whether property is undergoing gut rehabilitation Whether property is undergoing gut rehabilitation
Whether gas appliances are present Whether gas appliances are present
Whether a home energy assessment has been completed Whether a home energy assessment has been completed
Number of people in household Number of people in household
4
Mailing address if different from property address Mailing address if different from property address
Mailing address city Mailing address city
Mailing address state Mailing address state
Mailing address ZIP code Mailing address ZIP code
Alternate phone number Alternate phone number
Business tax status Business tax status
California entity ID California entity ID
County or parish name County or parish name
"Fulton County"
Whether customer identifies as indigenous Whether customer identifies as indigenous
Whether customer is a veteran Whether customer is a veteran
Whether customer is a senior Whether customer is a senior
Whether customer is a first responder Whether customer is a first responder
Additional property details as JSONB Additional property details as JSONB
Customer's utility rate plan Customer's utility rate plan
"R-1B"
Status of utility account Status of utility account
active, inactive, pending Number of dwelling units in building Number of dwelling units in building
1
Whether this is a test customer record Whether this is a test customer record
Array of devices associated with this customer Array of devices associated with this customer
Show child attributes
Show child attributes
Unique identifier for this customer device record Unique identifier for this customer device record
45
ID of the customer who owns this device ID of the customer who owns this device
609
ID of the device from the devices catalog ID of the device from the devices catalog
240
Number of devices purchased Number of devices purchased
1
Price paid for the device Price paid for the device
599.99
Cost of installation Cost of installation
450
Total cost including equipment and installation Total cost including equipment and installation
1049.99
Date device was purchased Date device was purchased
"2025-01-05"
Date device was installed Date device was installed
"2025-01-10"
Age of equipment being replaced Age of equipment being replaced
15
Whether existing equipment is still operational Whether existing equipment is still operational
false
Manufacturer of existing equipment Manufacturer of existing equipment
100"Old Brand"
Model of existing equipment Model of existing equipment
100"Model-X"
Where device was installed Where device was installed
100"Garage"
Name of contractor who performed installation Name of contractor who performed installation
200"ABC Electric"
Contractor's license number Contractor's license number
100"EC-12345"
Whether required permits were obtained Whether required permits were obtained
true
Whether inspection passed Whether inspection passed
true
Date application was submitted Date application was submitted
"2025-01-15"
Permit number Permit number
"PMT-2025-001"
Make of vehicle (for EV chargers) Make of vehicle (for EV chargers)
"Tesla"
Model of vehicle (for EV chargers) Model of vehicle (for EV chargers)
"Model 3"
Year of vehicle (for EV chargers) Year of vehicle (for EV chargers)
2023
Vehicle identification number Vehicle identification number
"5YJ3E1EA9KF123456"
Dealership where vehicle was purchased Dealership where vehicle was purchased
"Tesla Atlanta"
Contractor's email Contractor's email
Contractor's phone number Contractor's phone number
"555-987-6543"
Contractor's website Contractor's website
"https://www.abcelectric.com"
Whether trenching was required for installation Whether trenching was required for installation
false
Name of contractor contact person Name of contractor contact person
255"Jane Smith"
Contractor's street address Contractor's street address
255"789 Business Blvd"
Contractor's city Contractor's city
255"Atlanta"
Contractor's state Contractor's state
255"GA"
Contractor's ZIP code Contractor's ZIP code
20"30301"
Whether photos of existing equipment were provided Whether photos of existing equipment were provided
Serial number of existing equipment Serial number of existing equipment
255Type of existing heating system Type of existing heating system
255"Gas furnace"
Serial number of new device Serial number of new device
255"SN-123456789"
Whether device has louvered sides Whether device has louvered sides
Contractor's fax number Contractor's fax number
Make and model of coil (for HVAC) Make and model of coil (for HVAC)
Timestamp when record was created Timestamp when record was created
"2025-01-10T12:00:00Z"
Timestamp when record was last updated Timestamp when record was last updated
"2025-01-15T14:30:00Z"
Was this page helpful?