# GreenCalc — EU Renovation Subsidy Calculator API
> GreenCalc is a REST API that calculates eligibility for energy renovation subsidies across 5 EU countries (France, Germany, Italy, Belgium, Spain). Developers send a household profile and planned renovation works, and receive every eligible grant, loan, and tax benefit with exact amounts in EUR.

## Key Facts
- Type: REST API (JSON over HTTPS)
- Countries: France, Germany, Italy, Belgium, Spain
- Schemes: MaPrimeRenov', CEE, Eco-PTZ, KfW 262, BEG EM, Superbonus, Ecobonus, Bonus Casa, Prime Wallonie, Renolution Brussels, PREE, MOVES III
- Work types: 11 normalized codes (ROOF_INSULATION, HEAT_PUMP_AIR_WATER, WALL_INSULATION_EXTERIOR, WINDOWS_DOUBLE_GLAZING, SOLAR_PANELS_PHOTOVOLTAIC, etc.)
- Response time: <50ms average
- Pricing: Free sandbox (no signup), €29/mo Developer, €99/mo Startup, €349/mo Scale
- Documentation: https://greencalc.io/docs/
- Sandbox API key: gc_sandbox_000000000000000000000000000000000

## Quick Start
```bash
curl -X POST https://greencalc.io/api/v1/eligibility/simulate \
  -H "X-Api-Key: gc_sandbox_000000000000000000000000000000000" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"FR","household":{"annual_income":25000,"household_size":3,"is_owner":true},"property":{"type":"HOUSE","energy_rating":"E","postal_code":"59000","surface_m2":120},"planned_works":[{"work_type":"ROOF_INSULATION","estimated_cost_eur":8000,"surface_m2":80}]}'
```

## API Endpoints
- POST /api/v1/eligibility/simulate — Calculate all eligible subsidies
- GET /api/v1/eligibility/countries — List supported countries and schemes
- GET /api/v1/eligibility/health — API health status
- GET /api/v1/eligibility/changelog — Regulatory change log
- GET /api/v1/eligibility/work-types — List normalized work type codes

## Subsidy Response Fields
Each eligible subsidy includes: scheme_code, scheme_name, provider, type (GRANT/LOAN/TAX_CREDIT/VAT_REDUCTION), amount_eur, rate_percent, conditions, cumulative (combinable with others).

The summary includes: total_estimated_cost_eur, total_grants_eur, total_loans_eur, total_tax_savings_eur, estimated_out_of_pocket_eur, estimated_new_energy_rating, estimated_energy_saving_percent.

## Use Cases
- Neobanks: Embed subsidy calculations in green loan application flows
- Energy comparators: Show customers total savings including subsidies
- PropTech platforms: Add renovation cost estimators to property listings
- Fintech builders: Build green finance products on top of subsidy data
- Insurtech: Assess renovation value for green property insurance
- Government portals: Provide subsidy calculators to citizens

## Countries Detail
- France: MaPrimeRenov' (income-based grants), CEE (energy certificates), Eco-PTZ (zero-interest loan), TVA 5.5%
- Germany: KfW 262 (efficient building loan with repayment grant), BEG EM (individual measure grants), BAFA audit
- Italy: Superbonus (65% tax credit), Ecobonus (50-65%), Bonus Casa (50%)
- Belgium: Prime Wallonie, Renolution Brussels, Mijn VerbouwPremie Flanders
- Spain: PREE (35-65% rehabilitation grant), MOVES III (EV charging)

## Company
Built by AZMORIS Group (https://azmoris.io)
Tech stack: Java 21, Spring Boot 3.3, PostgreSQL 16, Redis 7