Skip to main content
Elovane
Documentation

Quickstart

Get your API key and run your first solar ROI calculation in under 5 minutes.

1Get Your API Key

Create a free account to get your API key. The free tier includes 50 requests per day.

curl -X POST https://elovane-api.smarttechinvest.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"name":"Your Name","email":"you@example.com","password":"your_password"}'

The response includes your API key. Save it -- you will not see it again.

{
  "data": {
    "message": "Account created",
    "apiKeyPrefix": "elv_live...",
    "apiKey": "elv_live_a1b2c3d4e5f6..."
  },
  "meta": { "timestamp": "2026-03-19T00:00:00Z" }
}

2Run Your First Calculation

Submit a solar ROI calculation with your zip code's solar production, annual consumption, and utility rate:

curl -X POST https://elovane-api.smarttechinvest.com/v1/calculate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: elv_live_your_api_key_here" \
  -d '{
    "annualProductionPerKW": 1400,
    "annualConsumptionKWh": 10000,
    "utilityRate": 0.15,
    "state": "CA"
  }'

Response:

{
  "data": {
    "sizing": { "optimalSizeKW": 7.14, "annualProductionKWh": 10000 },
    "credits": {
      "federalITC": 6426,
      "stateCredits": 1000,
      "utilityRebates": 0,
      "totalCredits": 7426
    },
    "npv": { "npv25Year": 18420, "irr": 0.124 },
    "lcoe": { "solarLCOE": 0.062, "utilityLCOE": 0.15 },
    "payback": { "simplePaybackYears": 8.2, "discountedPaybackYears": 9.4 },
    "sequencing": {
      "optimalOrder": ["solar", "battery", "heat_pump"],
      "reasoning": "Solar first maximizes ITC credit base..."
    }
  },
  "meta": { "timestamp": "2026-03-19T00:00:00Z", "source": "elovane-api" }
}

3Look Up Incentives

Get federal and state incentives for any state:

curl https://elovane-api.smarttechinvest.com/v1/incentives/CA \
  -H "X-API-Key: elv_live_your_api_key_here"

4Use in Your App

JavaScript / TypeScript

const response = await fetch(
  'https://elovane-api.smarttechinvest.com/v1/calculate',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ELOVANE_API_KEY,
    },
    body: JSON.stringify({
      annualProductionPerKW: 1400,
      annualConsumptionKWh: 10000,
      utilityRate: 0.15,
    }),
  }
);
const { data } = await response.json();
console.log(`25-year NPV: $${data.npv.npv25Year}`);

Python

import requests
import os

resp = requests.post(
    "https://elovane-api.smarttechinvest.com/v1/calculate",
    headers={"X-API-Key": os.environ["ELOVANE_API_KEY"]},
    json={
        "annualProductionPerKW": 1400,
        "annualConsumptionKWh": 10000,
        "utilityRate": 0.15,
    }
)
data = resp.json()["data"]
print("25-year NPV: $" + str(data["npv"]["npv25Year"]))

Next Steps