Setup
Create your API Key
Leap will share an API Key for authenticating requests.
Map devices to your system
Send your list of devices and Leap will return the list with device_id mapped for your API requests.
Set up Claimed Fields (Optional)
Define which data fields your system will provide vs. what customers will enter directly.
Check Eligibility & Get URL Check a customer’s eligibility for incentives. Leap will return a Connect URL which customers use to submit applications across all eligible programs.
Request POST /incentives { "operation_type" : "lookup" , "reference_id" : "ref-12345" , "address" : { "street_1" : "456 Main St" , "street_2" : "Apt 2B" , "city" : "Bend" , "state_or_province_code" : "OR" , "postal_code" : "97701" , "country_code" : "US" }, "building_type" : "RESIDENTIAL" , "device_id" : 123 , "create_application" : true } Response Examples
{ "utility" : { "eiaid" : 14354 , "name" : "PacifiCorp (Oregon)" }, "address" : { "street_1" : "456 Main St" , "street_2" : "Apt 2B" , "city" : "Bend" , "state_or_province_code" : "OR" , "postal_code" : "97701" , "country_code" : "US" }, "building_type" : "RESIDENTIAL" , "customer_id" : 453 , "reference_id" : "ref-12345" , "programs_evaluated" : 2 , "incentives" : { "total_incentive_amount" : 750 , "total_eligible_combinations" : 1 , "by_program" : [ { "program_id" : 838 , "program_name" : "Pacific Power – Oregon \" Charge at Home \" EV Charger Rebate" , "total_incentive" : 750 , "eligible_combinations" : 1 , "device_tier_results" : [ { "device_id" : 123 , "device_name" : "Level 2 EV Charger" , "tier_id" : 456 , "tier_name" : "Standard Rebate" , "eligible" : true , "incentive_amount" : 750 , "calculation_details" : { "base_amount" : 750 , "calculation_method" : "Fixed rebate per device" }, "failed_requirements" : [], "ignored_requirements" : [ "Installation must be within 90 days of application" , "Must use licensed contractor" ] } ] } ] }, "connect_url" : "https://app.leap.energy/connect/abc123" }
{ "utility" : { "eiaid" : 15248 , "name" : "Portland General Electric Co" }, "address" : { "street_1" : "100 SW Main St" , "street_2" : "" , "city" : "Portland" , "state_or_province_code" : "OR" , "postal_code" : "97204" , "country_code" : "US" }, "building_type" : "RESIDENTIAL" , "customer_id" : 454 , "reference_id" : "ref-67890" , "programs_evaluated" : 1 , "incentives" : { "total_incentive_amount" : 0 , "total_eligible_combinations" : 0 , "by_program" : [ { "program_id" : 900 , "program_name" : "PGE Smart Charging – Tesla Telematics Path" , "total_incentive" : 0 , "eligible_combinations" : 0 , "device_tier_results" : [ { "device_id" : 123 , "device_name" : "Dumb Level 1 Charger" , "tier_id" : 501 , "tier_name" : "Smart Charger Tier" , "eligible" : false , "incentive_amount" : 0 , "calculation_details" : {}, "failed_requirements" : [ "Device not OCPP compliant" , "Charger level must be at least LEVEL_2" ], "ignored_requirements" : [] } ] } ] } }
{ "utility" : { "eiaid" : 17609 , "name" : "Sacramento Municipal Util Dist" }, "address" : { "street_1" : "789 Oak Avenue" , "street_2" : "" , "city" : "Sacramento" , "state_or_province_code" : "CA" , "postal_code" : "95814" , "country_code" : "US" }, "building_type" : "RESIDENTIAL" , "customer_id" : 455 , "reference_id" : "ref-24680" , "programs_evaluated" : 2 , "incentives" : { "total_incentive_amount" : 1250 , "total_eligible_combinations" : 2 , "by_program" : [ { "program_id" : 1001 , "program_name" : "SMUD Charge@Home EV Rebates" , "total_incentive" : 500 , "eligible_combinations" : 1 , "device_tier_results" : [ { "device_id" : 123 , "device_name" : "Level 2 EV Charger" , "tier_id" : 789 , "tier_name" : "Standard Tier" , "eligible" : true , "incentive_amount" : 500 , "calculation_details" : { "base_amount" : 500 }, "failed_requirements" : [], "ignored_requirements" : [ "Installation must be within 90 days of application" ] } ] }, { "program_id" : 1002 , "program_name" : "SMUD Go Electric Bonus – Residential Panel-Upgrade & Make-Ready Rebate" , "total_incentive" : 750 , "eligible_combinations" : 1 , "device_tier_results" : [ { "device_id" : 456 , "device_name" : "Electric Panel Upgrade" , "tier_id" : 790 , "tier_name" : "Panel Make Ready" , "eligible" : true , "incentive_amount" : 750 , "calculation_details" : { "base_amount" : 750 }, "failed_requirements" : [], "ignored_requirements" : [ "Must use licensed contractor" ] } ] } ] }, "connect_url" : "https://app.leap.energy/connect/ghi789" } Place in Your App Flow Place the offer to Claim Incentives inside your customer journey.
Post Purchase Email Send the incentive link in your order confirmation or follow-up emails
Order Confirmation Display immediately after purchase completion
App Setup Integrate into your product setup or onboarding flow
Customer Fills the Application Customer completes the application in Leap Connect. After completion, application_status is updated to awaiting_partner or completed.
The customer will provide required documentation and consent for data sharing during this step.
Upload Claimed Fields Provide information to complete the customer’s application.
Step 1: Search for Applications Search for applications in awaiting_partner status. Applications are automatically filtered to your organization.
GET /applications?application_status=awaiting_partner x-api-key : YOUR_API_KEY Response: { "next_page_token" : null , "results" : [ { "id" : 123 , "program_id" : 339 , "customer_id" : 609 , "customer_device_id" : [ 45 ], "status" : "awaiting_partner" , "rebate_type" : "instant" , "payee_type" : "customer" , "total_requested_amount" : 1500.00 , "created_at" : "2025-01-10T15:30:00Z" , "updated_at" : "2025-01-15T10:45:00Z" , "customer" : { "id" : 609 , "first_name" : "John" , "last_name" : "Doe" , "email" : "[email protected] " , "phone" : "555-123-4567" , "address_line1" : "123 Main St" , "city" : "Atlanta" , "state" : "GA" , "zip_code" : "30303" } } ] } Step 2: Update Application Upload partner data using the application ID from the search results.
PATCH /applications/123 x-api-key : YOUR_API_KEY Request: { "status" : "completed" , "customer" : { "first_name" : "John" , "last_name" : "Doe" , "email" : "[email protected] " , "phone" : "555-1234" }, "customer_devices" : [ { "id" : 45 , "purchase_date" : "2025-01-15" , "installation_date" : "2025-01-20" , "contractor_name" : "ABC Electric" , "contractor_license" : "EC-12345" } ] } This endpoint requires API key authentication via x-api-key header. The application must belong to your organization.
The PATCH endpoint supports partial updates - only include fields you want to modify. Application fields can be updated at the top level (e.g., status, approval_date), and customer/devices can be updated in nested objects.
