Reports & Assessments

Generate professional PDF reports and site assessments for stakeholders and investors.

Site Assessment

Endpoint

POST /solar/assess

Request

{
  "project_name": "Desert Sun Solar",
  "client_name": "Acme Energy",
  "latitude": 35.0,
  "longitude": -110.0,
  "capacity_kw": 5000,
  "tilt": 30.0,
  "azimuth": 180.0
}

Response

{
  "assessment_id": "550e8400-e29b-41d4-a716-446655440000",
  "project_name": "Desert Sun Solar",
  "site_quality": "excellent",
  "site_score": 92,
  "solar_resource": {
    "annual_ghi": 2150.5,
    "annual_dni": 2450.3,
    "resource_class": "Class 1"
  },
  "energy_estimate": {
    "annual_energy_mwh": 9250.5,
    "capacity_factor": 0.211,
    "p50_energy_mwh": 9250.5,
    "p90_energy_mwh": 8780.0
  },
  "financial_summary": {
    "lcoe_cents_per_kwh": 3.45,
    "npv_dollars": 6250000,
    "irr_percent": 14.5,
    "payback_years": 6.2
  },
  "recommendations": [
    "Site has excellent solar resource with annual GHI > 2000 kWh/m²",
    "Recommended tilt of 32° for maximum energy yield",
    "Consider single-axis tracking for 15-20% additional yield"
  ]
}

PDF Report Generation

Endpoint

POST /solar/report

Request

{
  "project_name": "Desert Sun Solar",
  "client_name": "Acme Energy",
  "latitude": 35.0,
  "longitude": -110.0,
  "capacity_kw": 5000,
  "include_sections": ["executive_summary", "solar_resource", "energy", "financial", "recommendations"]
}

Response

{
  "report_id": "550e8400-e29b-41d4-a716-446655440000",
  "filename": "Desert_Sun_Solar_Report_20260125.pdf",
  "download_url": "/solar/report/download/Desert_Sun_Solar_Report_20260125.pdf",
  "expires_at": "2026-01-26T00:00:00Z"
}

Download Report

Endpoint

GET /solar/report/download/{filename}

Returns the PDF file directly.

Code Examples

PythoncURL

import requests

# Generate report
response = requests.post(
    "https://api.tessellaterenewables.com/solar/report",
    json={
        "project_name": "Desert Sun Solar",
        "client_name": "Acme Energy",
        "latitude": 35.0,
        "longitude": -110.0,
        "capacity_kw": 5000
    }
)

report = response.json()
download_url = f"https://api.tessellaterenewables.com{report['download_url']}"

# Download PDF
pdf_response = requests.get(download_url)

with open(report['filename'], 'wb') as f:
    f.write(pdf_response.content)

print(f"Report saved: {report['filename']}")

# Generate report
REPORT=$(curl -s -X POST \
  https://api.tessellaterenewables.com/solar/report \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": "Desert Sun Solar",
    "latitude": 35.0,
    "longitude": -110.0,
    "capacity_kw": 5000
  }')

FILENAME=$(echo $REPORT | jq -r '.filename')

# Download PDF
curl -o "$FILENAME" \
  "https://api.tessellaterenewables.com/solar/report/download/$FILENAME"

echo "Downloaded: $FILENAME"

Report Sections

Section	Description
executive_summary	1-page overview for executives
solar_resource	Irradiance data and analysis
energy	Production estimates with P50/P90
financial	LCOE, NPV, IRR, cash flows
technical	System specifications
recommendations	Optimization suggestions
appendix	Detailed data tables

Report Customization

{
  "project_name": "My Project",
  "include_sections": ["executive_summary", "financial"],
  "branding": {
    "logo_url": "https://example.com/logo.png",
    "company_name": "Your Company",
    "primary_color": "#FF6B35"
  },
  "financial_assumptions": {
    "electricity_price": 0.06,
    "discount_rate": 0.08,
    "project_life_years": 25
  }
}

Site Quality Ratings

Score	Rating	Description
90-100	Excellent	Top-tier solar resource
75-89	Good	Above average conditions
60-74	Moderate	Viable with optimization
< 60	Poor	May not be economical