{
"status": "success",
"api_version": "1.0.0",
"financing_structure_scope": "This engine's DSCR / covenant bankability layer (see 'dscr' block below) assumes non-recourse, SPV-style project finance. It does not model corporate/balance-sheet-recourse financing structures, which are underwritten differently (consolidated financials, interest coverage) and are out of scope for this version.",
"input": {
"country": "Nigeria",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 2400,
"nameplate_kva": 500,
"load_fraction": 0.75,
"target_displacement_pct": 70,
"backup_hours_target": 4
},
"country_context": {
"irradiance_kwh_m2_yr": 1850,
"grid_availability_pct": 45,
"diesel_price_usd_l": 0.55,
"grid_tariff_usd_kwh": 0.035,
"currency": "NGN",
"ambient_temp_c": 32,
"source_irradiance": "NASA POWER MERRA-2; Fraunhofer ISE PV Report 2024",
"source_diesel": "GIZ HERA (2019); NNPC pump price 2024"
},
"diesel_baseline": {
"fuel_cost_usd_kwh": 0.1969,
"maintenance_usd_kwh": 0.015,
"replacement_amort_usd_kwh": 0.0292,
"total_all_in_usd_kwh": 0.2411,
"fuel_consumption_lph": 107.4,
"load_kw": 300,
"source_fuel_curve": "ISO 8528-1:2005 §13",
"source_maintenance": "GIZ HERA (2019); Wood Mackenzie Africa C&I (2022)"
},
"generator_health": {
"load_fraction": 0.75,
"load_kw": 300,
"wet_stack_risk": false,
"warning": null,
"source": "Cummins Power Generation Application Note (2002); GIZ HERA (2019) §4.3"
},
"grid_downtime_cost": {
"grid_availability_pct": 45,
"grid_down_hours_yr": 4818,
"backup_energy_needed_kwh": 481800,
"diesel_backup_cost_usd_yr": 116162,
"productive_loss_usd_yr": null,
"productive_loss_plausibility_flag": null,
"total_downtime_cost_usd_yr": 116162,
"source": "World Bank Enterprise Surveys (2023); ESMAP (2023); GIZ HERA (2019)"
},
"solar_sizing": {
"pv_capacity_kw_dc": 689.5,
"inverter_ac_capacity_kw": 574.6,
"dc_ac_ratio": 1.2,
"annual_pv_output_kwh_ac": 830375,
"direct_solar_consumed_kwh": 597870,
"solar_fraction_pct_sizing": 68.2,
"note_solar_fraction": "This is the pre-BESS sizing estimate. dispatch_model.diesel_displacement_pct is the authoritative post-dispatch figure.",
"curtailed_kwh_upper": 232505,
"specific_yield_kwh_kwp": 1235,
"thermal_derating_factor": 0.856,
"system_pr": 0.78,
"capex_usd_per_wp": 0.78,
"pv_capex_usd": 537804,
"source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
"source_yield": "PVGIS-SARAH2; Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
"source_thermal": "King et al. (2004) NREL; IEC 61215:2021 §11.5",
"source_capex": "NREL ATB 2024 Commercial PV + Africa logistics premium (Wood Mackenzie 2024)"
},
"land_area": {
"ground_mount_m2": 5516,
"rooftop_m2": 4137,
"ground_mount_ha": 0.55,
"note": "Ground-mount includes inter-row spacing for 0°–30° latitude sites.",
"source": "NREL Land-Use Requirements for Solar Power Plants (2013); Fraunhofer ISE 2024"
},
"bess_sizing": {
"bess_usable_energy_kwh": 400,
"bess_nameplate_energy_kwh": 522.9,
"bess_power_kw": 261.4,
"backup_hours_achieved": 4,
"round_trip_efficiency_pct": 85,
"depth_of_discharge_pct": 90,
"daily_cycle_rate": 0.8,
"pack_cost_usd": 94118,
"bos_cost_usd": 31373,
"bess_capex_usd": 125490,
"effective_life_years": 12,
"cycle_limited": true,
"soh_degradation_curve": {
"year_1": 98.3,
"year_3": 95,
"year_5": 91.7,
"year_7": 88.3,
"year_11": 81.6,
"end_of_life_trigger": "80% SOH — replacement recommended"
},
"lcos_usd_per_mwh": 120,
"lcos_benchmark_range": "USD 160–250/MWh for LFP (PNNL-33283; BloombergNEF 2024)",
"source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162",
"source_capex": "NREL ATB 2024 two-component formula; BloombergNEF BESS Survey 2024",
"source_lcos": "Mongird et al. (2022) PNNL-33283 §5.1",
"source_rte": "NREL ATB 2024 Storage — LFP round-trip efficiency",
"source_soh": "Mongird et al. (2022) PNNL-33283 §4.2; CATL LFP datasheet"
},
"dispatch_model": {
"annual_load_kwh": 876000,
"solar_direct_kwh": 569400,
"bess_charge_kwh": 81760,
"bess_to_load_kwh": 69496,
"generator_kwh": 237104,
"curtailed_kwh": 179215,
"solar_fraction_pct": 72.9,
"diesel_displaced_kwh": 638896,
"diesel_displacement_pct": 72.9,
"source": "Lambert et al. (2006) HOMER merit-order dispatch; IEEE Std 1562-2007"
},
"financials": {
"total_capex_usd": 729623,
"base_capex_usd": 663294,
"contingency_capex_usd": 66329,
"pv_capex_usd": 537804,
"bess_capex_usd": 125490,
"tax_benefit_yr1_usd": 0,
"tax_benefit_note": "No Pioneer Status tax holiday applied — this is the conservative base case. Pioneer Status under the NIPC Act requires a formal application, approval, and a gazetted qualifying sector — it is not automatic. If this project has confirmed Pioneer Status approval, rerun with pioneer_status_confirmed=true to model the 3-yr CIT holiday upside. Source: NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023.",
"tax_benefit_treatment": "Tax holiday / accelerated depreciation benefit is realised as a one-time Year-1 operating cashflow addback (see cashflows_all_25yr[0]), not as a reduction of project capex. Debt and equity are sized against gross total_capex_usd. This matches conventional DFI/IFC project-finance treatment: construction is financed at full cost before any tax benefit is realised; the tax shield improves debt service coverage in the year it is claimed rather than reducing the amount financed.",
"net_capex_after_tax_usd": 729623,
"net_capex_after_tax_usd_note": "Memo figure only — shown for reference, not used in NPV, IRR, payback, or debt sizing. See tax_benefit_treatment above.",
"annual_diesel_savings_usd": 154038,
"annual_om_usd": 10577,
"annual_insurance_usd": 3316,
"npv_usd": 814913,
"irr_pct": 21.3,
"simple_payback_years": 5,
"lcoe_solar_bess_usd_kwh": 0.0586,
"diesel_allin_cost_usd_kwh": 0.2411,
"lcoe_vs_diesel_usd_kwh": 0.1825,
"co2_saved_tonnes_yr": 613,
"co2_saved_tonnes_25yr": 15325,
"diesel_saved_litres_yr": 228725,
"discount_rate_pct": 10,
"diesel_escalation_pct_yr": 3,
"project_life_yr": 25,
"source_irena": "IRENA (2023) Renewable Power Generation Costs §4",
"source_tax": "NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023",
"source_co2": "IPCC 2006 Guidelines Vol 2 Ch1 Table 1.4; EPA GHG emission factors",
"source_ifc": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa"
},
"dscr": {
"financing_structure": "non_recourse_project_finance_spv",
"scope_note": "DSCR and covenant results assume non-recourse, SPV-style project finance. Not applicable as-is to corporate/balance-sheet-recourse financing, which is underwritten on consolidated financials and interest coverage, not isolated project CFADS.",
"debt_fraction_pct": 70,
"debt_amount_usd": 510736,
"equity_amount_usd": 218887,
"loan_tenor_yr": 10,
"interest_rate_pct": 12,
"annual_debt_service_usd": 90392,
"dscr_year_1": 1.54,
"dscr_minimum": 1.54,
"dscr_minimum_year": 1,
"lender_threshold": 1.3,
"lender_bankability": "PASS",
"note": "IFC minimum DSCR for green energy projects in Sub-Saharan Africa is 1.30. Projects below this require additional credit enhancement or concessional debt.",
"source": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa; World Bank ESMAP project finance guidelines (2022)",
"covenant_table": [
{
"year": 1,
"cfads_usd": 139130,
"annual_debt_service": 90392,
"dscr": 1.54,
"below_ifc_minimum": false,
"lockup_triggered": false,
"default_triggered": false,
"distribution_allowed": true,
"covenant_status": "COMPLIANT"
},
{
"year": 2,
"cfads_usd": 142689,
"annual_debt_service": 90392,
"dscr": 1.58,
"below_ifc_minimum": false,
"lockup_triggered": false,
"default_triggered": false,
"distribution_allowed": true,
"covenant_status": "COMPLIANT"
},
{
"year": 3,
"cfads_usd": 146338,
"annual_debt_service": 90392,
"dscr": 1.62,
"below_ifc_minimum": false,
"lockup_triggered": false,
"default_triggered": false
}
]
},
"_note": "Response truncated for documentation purposes"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30326/pre-feasibility+screening+report' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"avg_daily_load_kwh": 2400,
"backup_hours_target": 4,
"country": "nigeria",
"load_fraction": 0.75,
"load_profile": "manufacturing",
"nameplate_kva": 500,
"target_diesel_displacement_pct": 70
}'
{
"status": "success",
"api_version": "1.0.0",
"financing_structure_scope": "This engine's DSCR / covenant bankability layer (see 'dscr' block below) assumes non-recourse, SPV-style project finance. It does not model corporate/balance-sheet-recourse financing structures, which are underwritten differently (consolidated financials, interest coverage) and are out of scope for this version.",
"input": {
"country": "South Africa",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 4800,
"nameplate_kva": 1000,
"load_fraction": 0.75,
"target_displacement_pct": 75,
"backup_hours_target": 6
},
"country_context": {
"irradiance_kwh_m2_yr": 1950,
"grid_availability_pct": 65,
"diesel_price_usd_l": 1.1,
"grid_tariff_usd_kwh": 0.135,
"currency": "ZAR",
"ambient_temp_c": 22,
"source_irradiance": "PVGIS-SARAH2 (EU JRC); GeoSUN Africa atlas",
"source_diesel": "SAPIA 2024"
},
"diesel_baseline": {
"fuel_cost_usd_kwh": 0.3938,
"maintenance_usd_kwh": 0.015,
"replacement_amort_usd_kwh": 0.0292,
"total_all_in_usd_kwh": 0.438,
"fuel_consumption_lph": 214.8,
"load_kw": 600,
"source_fuel_curve": "ISO 8528-1:2005 §13",
"source_maintenance": "GIZ HERA (2019); Wood Mackenzie Africa C&I (2022)"
},
"generator_health": {
"load_fraction": 0.75,
"load_kw": 600,
"wet_stack_risk": false,
"warning": null,
"source": "Cummins Power Generation Application Note (2002); GIZ HERA (2019) §4.3"
},
"grid_downtime_cost": {
"grid_availability_pct": 65,
"grid_down_hours_yr": 3066,
"backup_energy_needed_kwh": 613200,
"diesel_backup_cost_usd_yr": 268582,
"productive_loss_usd_yr": 3679200,
"productive_loss_plausibility_flag": null,
"total_downtime_cost_usd_yr": 3947782,
"source": "World Bank Enterprise Surveys (2023); ESMAP (2023); GIZ HERA (2019)"
},
"solar_sizing": {
"pv_capacity_kw_dc": 1331.7,
"inverter_ac_capacity_kw": 1109.8,
"dc_ac_ratio": 1.2,
"annual_pv_output_kwh_ac": 1779375,
"direct_solar_consumed_kwh": 1281150,
"solar_fraction_pct_sizing": 73.1,
"note_solar_fraction": "This is the pre-BESS sizing estimate. dispatch_model.diesel_displacement_pct is the authoritative post-dispatch figure.",
"curtailed_kwh_upper": 498225,
"specific_yield_kwh_kwp": 1370,
"thermal_derating_factor": 0.901,
"system_pr": 0.78,
"capex_usd_per_wp": 0.78,
"pv_capex_usd": 1038732,
"source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
"source_yield": "PVGIS-SARAH2; Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
"source_thermal": "King et al. (2004) NREL; IEC 61215:2021 §11.5",
"source_capex": "NREL ATB 2024 Commercial PV + Africa logistics premium (Wood Mackenzie 2024)"
},
"land_area": {
"ground_mount_m2": 10654,
"rooftop_m2": 7990,
"ground_mount_ha": 1.07,
"note": "Ground-mount includes inter-row spacing for 0°–30° latitude sites.",
"source": "NREL Land-Use Requirements for Solar Power Plants (2013); Fraunhofer ISE 2024"
},
"bess_sizing": {
"bess_usable_energy_kwh": 1200,
"bess_nameplate_energy_kwh": 1568.6,
"bess_power_kw": 784.3,
"backup_hours_achieved": 6,
"round_trip_efficiency_pct": 85,
"depth_of_discharge_pct": 90,
"daily_cycle_rate": 0.8,
"pack_cost_usd": 282353,
"bos_cost_usd": 94118,
"bess_capex_usd": 376471,
"effective_life_years": 12,
"cycle_limited": true,
"soh_degradation_curve": {
"year_1": 98.3,
"year_3": 95,
"year_5": 91.7,
"year_7": 88.3,
"year_11": 81.6,
"end_of_life_trigger": "80% SOH — replacement recommended"
},
"lcos_usd_per_mwh": 120,
"lcos_benchmark_range": "USD 160–250/MWh for LFP (PNNL-33283; BloombergNEF 2024)",
"source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162",
"source_capex": "NREL ATB 2024 two-component formula; BloombergNEF BESS Survey 2024",
"source_lcos": "Mongird et al. (2022) PNNL-33283 §5.1",
"source_rte": "NREL ATB 2024 Storage — LFP round-trip efficiency",
"source_soh": "Mongird et al. (2022) PNNL-33283 §4.2; CATL LFP datasheet"
},
"dispatch_model": {
"annual_load_kwh": 1752000,
"solar_direct_kwh": 1138800,
"bess_charge_kwh": 245280,
"bess_to_load_kwh": 208488,
"generator_kwh": 404712,
"curtailed_kwh": 395295,
"solar_fraction_pct": 76.9,
"diesel_displaced_kwh": 1347288,
"diesel_displacement_pct": 76.9,
"source": "Lambert et al. (2006) HOMER merit-order dispatch; IEEE Std 1562-2007"
},
"financials": {
"total_capex_usd": 1556723,
"base_capex_usd": 1415203,
"contingency_capex_usd": 141520,
"pv_capex_usd": 1038732,
"bess_capex_usd": 376471,
"tax_benefit_yr1_usd": 420315,
"tax_benefit_note": "SA Income Tax Act §12B(1)(h) — solar PV not exceeding 1 MW. Nameplate 1000 kVA used as a proxy for generation capacity in kW (assumes power factor ~1.0 — confirm true kW rating before underwriting if this figure is within a few percent of the 1000 kVA / 1 MW threshold). Self-assessed allowance — no discretionary government approval required to claim, unlike Nigeria Pioneer Status or a Free Zone election. Trade-use requirement is satisfied by construction: this engine only models commercial/industrial load profiles, never residential. Ownership/instalment-credit-agreement and first-use conditions should still be confirmed with in-country counsel before underwriting — this figure assumes both are met. Reported value is the Year-1-present-value-equivalent of the 100% statutory schedule, not a flat rate.",
"tax_benefit_treatment": "Tax holiday / accelerated depreciation benefit is realised as a one-time Year-1 operating cashflow addback (see cashflows_all_25yr[0]), not as a reduction of project capex. Debt and equity are sized against gross total_capex_usd. This matches conventional DFI/IFC project-finance treatment: construction is financed at full cost before any tax benefit is realised; the tax shield improves debt service coverage in the year it is claimed rather than reducing the amount financed.",
"net_capex_after_tax_usd": 1136408,
"net_capex_after_tax_usd_note": "Memo figure only — shown for reference, not used in NPV, IRR, payback, or debt sizing. See tax_benefit_treatment above.",
"annual_diesel_savings_usd": 590112,
"annual_om_usd": 23110,
"annual_insurance_usd": 7076,
"npv_usd": 4986480,
"irr_pct": 46.3,
"simple_payback_years": 3,
"lcoe_solar_bess_usd_kwh": 0.0594,
"diesel_allin_cost_usd_kwh": 0.438,
"lcoe_vs_diesel_usd_kwh": 0.3786,
"co2_saved_tonnes_yr": 1292.6,
"co2_saved_tonnes_25yr": 32316,
"diesel_saved_litres_yr": 482329,
"cashflows_yr1_to_10": [
976757,
570490,
584891,
599652,
614785,
630296,
646197,
662496,
679204,
696331
],
"cashflows_all_25yr": [
976757,
570490,
584891,
599652,
614785,
630296,
646197,
662496,
679204,
696331,
713888,
731885,
750333,
769243,
788627,
808497,
828866,
849744,
871146,
893085,
915572,
938624,
962253,
986474,
1011301
],
"discount_rate_pct": 10,
"diesel_escalation_pct_yr": 3,
"project_life_yr": 25,
"source_irena": "IRENA (2023) Renewable Power Generation Costs §4",
"source_tax": "SA Income Tax Act §12B (Act 58 of 1962, amended 2023)",
"source_co2": "IPCC 2006 Guidelines Vol 2 Ch1 Table 1.4; EPA GHG emission factors",
"source_ifc": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa"
},
"dscr": {
"financing_structure": "non_recourse_project_finance_spv",
"scope_note": "DSCR and covenant results assume non-recourse, SPV-style project finance. Not applicable as-is to corporate/balance-sheet-recourse financing, which is underwritten on consolidated financials and interest coverage, not isolated project CFADS.",
"debt_fraction_pct": 70,
"debt_amount_usd": 1089706,
"equity_amount_usd": 467017,
"loan_tenor_yr": 10,
"interest_rate_pct": 12,
"annual_debt_service_usd": 192861,
"dscr_year_1": 5.06,
"dscr_minimum": 2.96,
"dscr_minimum_year": 2,
"lender_threshold": 1.3,
"lender_bankability": "PASS",
"note": "IFC minimum DSCR for green energy projects in Sub-Saharan Africa is 1.30. Projects below this require additional credit enhancement or concessional debt."
},
"_note": "Response truncated for documentation purposes"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30327/lender-grade+full+underwriting+model' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "south_africa",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 4800,
"nameplate_kva": 1000,
"load_fraction": 0.75,
"target_diesel_displacement_pct": 75,
"backup_hours_target": 6,
"project_life_yr": 25,
"discount_rate_pct": 10,
"revenue_per_operating_hour_usd": 1200,
"debt_fraction_pct": 70,
"loan_tenor_yr": 10,
"interest_rate_pct": 12.0,
"carbon_standard": "vcs"
}'
{
"status": "success",
"api_version": "1.0.0",
"sites_analysed": 3,
"portfolio_summary": {
"total_capex_usd": 3119874,
"total_annual_savings_usd": 1294720,
"total_co2_saved_tonnes_yr": 2896.9,
"total_carbon_net_revenue_yr_usd": 31286,
"avg_annual_savings_per_site_usd": 431573,
"dscr_lender_pass_count": 2,
"dscr_lender_fail_count": 1,
"sites_errored_count": 0,
"sites_successfully_analysed": 3,
"sites_by_viability": {
"marginal": 1,
"excellent": 2
}
},
"sites": [
{
"site_id": "factory_ZA_001",
"country": "South Africa",
"load_profile": "manufacturing",
"pv_capacity_kw": 2130.7,
"bess_energy_kwh": 1600,
"diesel_displacement_pct": 72.9,
"total_capex_usd": 2380325,
"npv_usd": 10281945,
"irr_pct": 57.3,
"payback_years": 2,
"dscr_lender_pass": true,
"annual_savings_usd": 1147202,
"co2_saved_tonnes_yr": 2506.7,
"carbon_net_revenue_yr_usd": 27072,
"lcoe_usd_kwh": 0.0478,
"diesel_allin_usd_kwh": 0.4489,
"fx_risk_level": "MEDIUM",
"viability": "excellent"
},
{
"site_id": "cold_KE_001",
"country": "Kenya",
"load_profile": "cold_chain",
"pv_capacity_kw": 359.7,
"bess_energy_kwh": 300,
"diesel_displacement_pct": 66.4,
"total_capex_usd": 459662,
"npv_usd": 732648,
"irr_pct": 25.8,
"payback_years": 5,
"dscr_lender_pass": true,
"annual_savings_usd": 117081,
"co2_saved_tonnes_yr": 268.6,
"carbon_net_revenue_yr_usd": 2901,
"lcoe_usd_kwh": 0.0812,
"diesel_allin_usd_kwh": 0.4028,
"fx_risk_level": "MEDIUM",
"viability": "excellent"
},
{
"site_id": "tower_NG_001",
"country": "Nigeria",
"load_profile": "telecoms_tower",
"pv_capacity_kw": 226.9,
"bess_energy_kwh": 160,
"diesel_displacement_pct": 73.8,
"total_capex_usd": 279887,
"npv_usd": -2199,
"irr_pct": null,
"payback_years": 10,
"dscr_lender_pass": false,
"annual_savings_usd": 30437,
"co2_saved_tonnes_yr": 121.6,
"carbon_net_revenue_yr_usd": 1313,
"lcoe_usd_kwh": 0.111,
"diesel_allin_usd_kwh": 0.2354,
"fx_risk_level": "HIGH",
"viability": "marginal"
}
],
"source": "ISO 8528-1:2005 | NREL ATB 2024 | NREL/TP-5400-63162 | IRENA 2023 | PNNL-33283 | Jordan & Kurtz (2013) | IFC (2023) project finance | Verra VCS VM0038",
"access": "entitled"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30328/portfolio+screening+and+fleet+ranking+report' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"sites": [
{
"site_id": "tower_NG_001",
"country": "nigeria",
"load_profile": "telecoms_tower",
"avg_daily_load_kwh": 480,
"nameplate_kva": 100,
"load_fraction": 0.80,
"target_diesel_displacement_pct": 80,
"backup_hours_target": 8
},
{
"site_id": "factory_ZA_001",
"country": "south_africa",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 9600,
"nameplate_kva": 2000,
"load_fraction": 0.70,
"target_diesel_displacement_pct": 60,
"backup_hours_target": 4
},
{
"site_id": "cold_KE_001",
"country": "kenya",
"load_profile": "cold_chain",
"avg_daily_load_kwh": 1200,
"nameplate_kva": 250,
"load_fraction": 0.85,
"target_diesel_displacement_pct": 55,
"backup_hours_target": 6
}
],
"project_life_yr": 25,
"discount_rate_pct": 10
}'
{
"status": "success",
"api_version": "1.0.0",
"report_type": "bankable_pre_feasibility",
"generated_at": "2026-08-26T14:15:34Z",
"access": "entitled",
"section_1_executive_summary": {
"viability_rating": "EXCELLENT",
"headline": "Excellent: 77% diesel displacement, 3-yr payback, 46.3% IRR. LCOE $0.059/kWh vs diesel $0.438/kWh. Lender DSCR: PASS.",
"pv_capacity_kw": 1331.7,
"bess_energy_kwh": 1200,
"diesel_displacement_pct": 76.9,
"total_capex_usd": 1556723,
"npv_usd": 4986480,
"irr_pct": 46.3,
"payback_years": 3,
"lcoe_solar_bess_usd_kwh": 0.0594,
"diesel_allin_usd_kwh": 0.438,
"lcoe_saving_per_kwh": 0.3786,
"annual_savings_usd": 590112,
"co2_saved_tonnes_yr": 1292.6,
"lender_bankability": "PASS",
"fx_risk_level": "MEDIUM"
},
"section_2_country_context": {
"irradiance_kwh_m2_yr": 1950,
"grid_availability_pct": 65,
"diesel_price_usd_l": 1.1,
"grid_tariff_usd_kwh": 0.135,
"currency": "ZAR",
"ambient_temp_c": 22,
"source_irradiance": "PVGIS-SARAH2 (EU JRC); GeoSUN Africa atlas",
"source_diesel": "SAPIA 2024",
"incentives": {
"section_12b": true,
"corporate_tax_rate": 0.27,
"vat_rate": 0.15,
"carbon_credit_eligible": true
},
"incentive_source": "SA Income Tax Act §12B (Act 58 of 1962, amended 2023)",
"downtime_analysis": {
"grid_availability_pct": 65,
"grid_down_hours_yr": 3066,
"backup_energy_needed_kwh": 613200,
"diesel_backup_cost_usd_yr": 268582,
"productive_loss_usd_yr": null,
"productive_loss_plausibility_flag": null,
"total_downtime_cost_usd_yr": 268582,
"source": "World Bank Enterprise Surveys (2023); ESMAP (2023); GIZ HERA (2019)"
}
},
"section_3_technical_design": {
"solar_sizing": {
"pv_capacity_kw_dc": 1331.7,
"inverter_ac_capacity_kw": 1109.8,
"dc_ac_ratio": 1.2,
"annual_pv_output_kwh_ac": 1779375,
"direct_solar_consumed_kwh": 1281150,
"solar_fraction_pct_sizing": 73.1,
"note_solar_fraction": "This is the pre-BESS sizing estimate. dispatch_model.diesel_displacement_pct is the authoritative post-dispatch figure.",
"curtailed_kwh_upper": 498225,
"specific_yield_kwh_kwp": 1370,
"thermal_derating_factor": 0.901,
"system_pr": 0.78,
"capex_usd_per_wp": 0.78,
"pv_capex_usd": 1038732,
"source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
"source_yield": "PVGIS-SARAH2; Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
"source_thermal": "King et al. (2004) NREL; IEC 61215:2021 §11.5",
"source_capex": "NREL ATB 2024 Commercial PV + Africa logistics premium (Wood Mackenzie 2024)"
},
"bess_sizing": {
"bess_usable_energy_kwh": 1200,
"bess_nameplate_energy_kwh": 1568.6,
"bess_power_kw": 784.3,
"backup_hours_achieved": 6,
"round_trip_efficiency_pct": 85,
"depth_of_discharge_pct": 90,
"daily_cycle_rate": 0.8,
"pack_cost_usd": 282353,
"bos_cost_usd": 94118,
"bess_capex_usd": 376471,
"effective_life_years": 12,
"cycle_limited": true,
"soh_degradation_curve": {
"year_1": 98.3,
"year_3": 95,
"year_5": 91.7,
"year_7": 88.3,
"year_11": 81.6,
"end_of_life_trigger": "80% SOH — replacement recommended"
},
"lcos_usd_per_mwh": 120,
"lcos_benchmark_range": "USD 160–250/MWh for LFP (PNNL-33283; BloombergNEF 2024)",
"source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162",
"source_capex": "NREL ATB 2024 two-component formula; BloombergNEF BESS Survey 2024",
"source_lcos": "Mongird et al. (2022) PNNL-33283 §5.1",
"source_rte": "NREL ATB 2024 Storage — LFP round-trip efficiency",
"source_soh": "Mongird et al. (2022) PNNL-33283 §4.2; CATL LFP datasheet"
},
"dispatch_model": {
"annual_load_kwh": 1752000,
"solar_direct_kwh": 1138800,
"bess_charge_kwh": 245280,
"bess_to_load_kwh": 208488,
"generator_kwh": 404712,
"curtailed_kwh": 395295,
"solar_fraction_pct": 76.9,
"diesel_displaced_kwh": 1347288,
"diesel_displacement_pct": 76.9,
"source": "Lambert et al. (2006) HOMER merit-order dispatch; IEEE Std 1562-2007"
},
"land_area": {
"ground_mount_m2": 10654,
"rooftop_m2": 7990,
"ground_mount_ha": 1.07,
"note": "Ground-mount includes inter-row spacing for 0°–30° latitude sites.",
"source": "NREL Land-Use Requirements for Solar Power Plants (2013); Fraunhofer ISE 2024"
},
"generator_health": {
"load_fraction": 0.75,
"load_kw": 600,
"wet_stack_risk": false,
"warning": null,
"source": "Cummins Power Generation Application Note (2002); GIZ HERA (2019) §4.3"
},
"thermal_derating": {
"ambient_temp_c": 22,
"derating_factor_applied": 0.901,
"note": "Cell temp = ambient + 25°C (NOCT); Pmax coeff = -0.45%/°C"
},
"inverter_sizing": {
"dc_ac_ratio": 1.2,
"inverter_ac_kw": 1109.8,
"pv_dc_kw": 1331.7,
"note": "DC:AC 1.20 — NREL standard for utility-adjacent C&I"
},
"design_note": "All sizing is pre-feasibility. Commission a licensed electrical engineer (IEC 62548 / NEC 690) before procurement."
},
"section_4_financial_model": {
"capex_breakdown": {
"pv_capex_usd": 1038732,
"bess_capex_usd": 376471,
"contingency_10pct_usd": 141520,
"total_capex_usd": 1556723
},
"tax_incentives": {
"tax_benefit_yr1_usd": 420315,
"net_capex_after_tax_usd": 1136408,
"tax_note": "SA Income Tax Act §12B(1)(h) — solar PV not exceeding 1 MW. Nameplate 1000 kVA used as a proxy for generation capacity in kW (assumes power factor ~1.0 — confirm true kW rating before underwriting if this figure is within a few percent of the 1000 kVA / 1 MW threshold). Self-assessed allowance — no discretionary government approval required to claim, unlike Nigeria Pioneer Status or a Free Zone election. Trade-use requirement is satisfied by construction: this engine only models commercial/industrial load profiles, never residential. Ownership/instalment-credit-agreement and first-use conditions should still be confirmed with in-country counsel before underwriting — this figure assumes both are met. Reported value is the Year-1-present-value-equivalent of the 100% statutory schedule, not a flat rate."
},
"annual_economics": {
"diesel_savings_yr1_usd": 590112,
"om_yr1_usd": 23110,
"insurance_yr1_usd": 7076,
"net_cashflow_yr1_usd": 976757,
"net_cashflow_yr1_note": "Includes the one-time Year-1 tax benefit addback (see tax_incentives.tax_benefit_yr1_usd above and financials.tax_benefit_treatment). This is why net_cashflow_yr1_usd is materially higher than diesel_savings_yr1_usd minus om/insurance alone."
},
"project_returns": {
"npv_usd": 4986480,
"irr_pct": 46.3,
"simple_payback_years": 3,
"lcoe_solar_bess": 0.0594,
"diesel_allin": 0.438,
"saving_per_kwh": 0.3786
},
"cashflow_schedule_25yr": [
976757,
570490,
584891,
599652,
614785,
630296,
646197,
662496,
679204,
696331,
713888,
731885,
750333,
769243,
788627,
808497,
828866,
849744,
871146,
893085,
915572,
938624,
962253,
986474,
1011301
],
"assumptions": {
"discount_rate_pct": 10,
"diesel_escalation_pct_yr": 3,
"pv_degradation_pct_yr": 0.5,
"project_life_yr": 25,
"om_escalation_pct_yr": 2
}
},
"section_5_debt_structuring": {
"financing_structure": "non_recourse_project_finance_spv",
"scope_note": "DSCR and covenant results assume non-recourse, SPV-style project finance. Not applicable as-is to corporate/balance-sheet-recourse financing, which is underwritten on consolidated financials and interest coverage, not isolated project CFADS.",
"debt_fraction_pct": 70,
"debt_amount_usd": 1089706,
"equity_amount_usd": 467017,
"loan_tenor_yr": 10,
"interest_rate_pct": 12,
"annual_debt_service_usd": 192861,
"dscr_year_1": 5.06,
"dscr_minimum": 2.96,
"dscr_minimum_year": 2
},
"_note": "Response truncated for documentation purposes"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30329/bankable+lender+package+8-section+report+data' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "south_africa",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 4800,
"nameplate_kva": 1000,
"load_fraction": 0.75,
"target_diesel_displacement_pct": 75,
"backup_hours_target": 6,
"debt_fraction_pct": 70,
"loan_tenor_yr": 10,
"interest_rate_pct": 12.0
}'
{
"status": "success",
"api_version": "1.0.0",
"access": "entitled",
"ppa_analysis": {
"ppa_tariff_usd_kwh": 0.09,
"ppa_escalation_pct_yr": 1.5,
"developer_wacc_pct": 12,
"developer_irr_pct": 4.62,
"developer_capex_usd": 729623,
"developer_tax_benefit_yr1_usd": 0,
"developer_npv_at_wacc_usd": -354260,
"ppa_revenue_yr1_usd": 57501,
"total_ppa_revenue_25yr_usd": 1728646,
"customer_saving_yr1_usd": 96537,
"customer_saving_yr1_pct_vs_diesel": 62.7,
"total_customer_savings_25yr_usd": 3887463,
"break_even_tariff_usd_kwh": 0.1537,
"zero_capex_for_customer": true,
"recommendation": "PPA preferred if customer WACC > developer WACC or customer has balance-sheet constraints. CAPEX preferred if customer has access to cheap capital and wants long-term asset ownership and all savings.",
"source": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa §3.2. CrossBoundary Energy EaaS model — 20-country, $707M portfolio (2025). SEIA (2024) Power Purchase Agreement framework. Kamoa Copper DRC: 222 MWp + 526 MWh BESS, EaaS structure, April 2025."
},
"capex_summary": {
"viability": "strong",
"headline": "Strong: 73% displacement, 5-yr payback, 21.3% IRR. LCOE $0.059/kWh replaces diesel at $0.241/kWh.",
"pv_capacity_kw": 689.5,
"bess_energy_kwh": 400,
"diesel_displacement_pct": 72.9,
"total_capex_usd": 729623,
"npv_usd": 814913,
"irr_pct": 21.3,
"payback_years": 5,
"dscr_lender_pass": true,
"dscr_bankability_score": "STRONG",
"lcoe_solar_bess_usd_kwh": 0.0586,
"diesel_allin_usd_kwh": 0.2411,
"co2_saved_tonnes_yr": 613,
"carbon_net_revenue_yr_usd": 6620,
"annual_savings_usd": 154038,
"fx_risk_level": "HIGH"
},
"country_context": {
"irradiance_kwh_m2_yr": 1850,
"grid_availability_pct": 45,
"diesel_price_usd_l": 0.55,
"grid_tariff_usd_kwh": 0.035,
"currency": "NGN",
"ambient_temp_c": 32,
"source_irradiance": "NASA POWER MERRA-2; Fraunhofer ISE PV Report 2024",
"source_diesel": "GIZ HERA (2019); NNPC pump price 2024"
},
"note": "PPA/EaaS is the dominant structure for C&I solar in Africa. CrossBoundary's Kamoa Copper DRC deal (222 MWp + 526 MWh, April 2025) and their $707M portfolio across 20 countries are all EaaS. See IFC (2023) §3.2 for PPA structuring guidance."
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30330/ppa+energy-as-a-service+deal+model' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "nigeria",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 2400,
"nameplate_kva": 500,
"load_fraction": 0.75,
"target_diesel_displacement_pct": 70,
"backup_hours_target": 4,
"ppa_tariff_usd_kwh": 0.09,
"ppa_escalation_pct_yr": 1.5,
"developer_wacc_pct": 12.0
}'
{
"scenarios": {
"conservative": {
"label": "Conservative (P90 irradiance, diesel −20%, CAPEX +15%)",
"irr_pct": 13.8,
"npv_usd": 316770,
"payback_years": 8,
"total_capex_usd": 914659,
"lcoe_usd_kwh": 0.0734,
"annual_savings_usd": 128865,
"dscr_year_1": 0.98,
"dscr_minimum": 0.98,
"dscr_minimum_year": 1,
"dscr_bankability": "FAIL — DSCR below 1.3",
"viability": "marginal",
"irradiance_used": 1665,
"diesel_price_used": 0.44
},
"base": {
"label": "Base Case (P50 irradiance, current diesel price)",
"irr_pct": 21.3,
"npv_usd": 814913,
"payback_years": 5,
"total_capex_usd": 729623,
"lcoe_usd_kwh": 0.0586,
"annual_savings_usd": 154038,
"dscr_year_1": 1.54,
"dscr_minimum": 1.54,
"dscr_minimum_year": 1,
"dscr_bankability": "PASS",
"viability": "strong",
"irradiance_used": 1850,
"diesel_price_used": 0.55
},
"optimistic": {
"label": "Optimistic (irradiance +5%, diesel +20%, CAPEX −5%)",
"irr_pct": 27.2,
"npv_usd": 1166436,
"payback_years": 4,
"total_capex_usd": 666380,
"lcoe_usd_kwh": 0.0535,
"annual_savings_usd": 179146,
"dscr_year_1": 2,
"dscr_minimum": 2,
"dscr_minimum_year": 1,
"dscr_bankability": "PASS",
"viability": "excellent",
"irradiance_used": 1942,
"diesel_price_used": 0.66
}
},
"investment_decision": "MARGINAL — consider concessional debt (6–8%) or DFI credit enhancement.",
"source": "IRENA (2023) Renewable Power Generation Costs §4.6 risk framework. IFC (2023) Mobilizing Private Investment §5 stress-test protocol. Arcadis (2025) sensitivity analysis methodology — 5MW solar PV plant. IEA PVPS Task 13 (2024) P90 definition: P90 ≈ P50 × 0.90 for Africa.",
"api_version": "1.0.0",
"access": "entitled"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30332/investment+committee+stress-test+matrix' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "nigeria",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 2400,
"nameplate_kva": 500,
"load_fraction": 0.75,
"target_diesel_displacement_pct": 70,
"backup_hours_target": 4,
"discount_rate_pct": 10,
"debt_fraction_pct": 70,
"loan_tenor_yr": 10,
"interest_rate_pct": 12.0
}'
{
"status": "success",
"api_version": "1.0.0",
"country": "Nigeria",
"diesel_price_usd_l": 0.55,
"grid_availability_pct": 45,
"top_sector": "commercial_office",
"top_sector_caveat": null,
"irr_leader_sector": "commercial_office",
"sectors_ranked_by_irr": [
{
"load_profile": "commercial_office",
"description": "Office buildings — HVAC, lighting, computers",
"solar_coincidence_pct": 80,
"diesel_displacement_pct": 78,
"pv_capacity_kw": 620.5,
"bess_energy_kwh": 400,
"total_capex_usd": 670465,
"npv_usd": 1001826,
"irr_pct": 24.9,
"payback_years": 5,
"annual_savings_usd": 164633,
"co2_saved_tonnes_yr": 655.1,
"lcoe_usd_kwh": 0.0504,
"dscr_lender_pass": true,
"viability": "strong"
},
{
"load_profile": "agro_processing",
"description": "Agricultural processing — milling, pumping, drying",
"solar_coincidence_pct": 78,
"diesel_displacement_pct": 75,
"pv_capacity_kw": 636.5,
"bess_energy_kwh": 400,
"total_capex_usd": 684118,
"npv_usd": 916151,
"irr_pct": 23.4,
"payback_years": 5,
"annual_savings_usd": 158315,
"co2_saved_tonnes_yr": 630,
"lcoe_usd_kwh": 0.0534,
"dscr_lender_pass": true,
"viability": "strong"
},
{
"load_profile": "manufacturing",
"description": "Heavy industry — motors, compressors, process heat",
"solar_coincidence_pct": 72,
"diesel_displacement_pct": 72.9,
"pv_capacity_kw": 689.5,
"bess_energy_kwh": 400,
"total_capex_usd": 729623,
"npv_usd": 814913,
"irr_pct": 21.3,
"payback_years": 5,
"annual_savings_usd": 154038,
"co2_saved_tonnes_yr": 613,
"lcoe_usd_kwh": 0.0586,
"dscr_lender_pass": true,
"viability": "strong"
},
{
"load_profile": "retail_mall",
"description": "Retail/mall — HVAC, lighting, escalators, refrigeration",
"solar_coincidence_pct": 60,
"diesel_displacement_pct": 72.9,
"pv_capacity_kw": 827.4,
"bess_energy_kwh": 720,
"total_capex_usd": 958372,
"npv_usd": 534764,
"irr_pct": 15.9,
"payback_years": 7,
"annual_savings_usd": 153862,
"co2_saved_tonnes_yr": 612.3,
"lcoe_usd_kwh": 0.0772,
"dscr_lender_pass": false,
"viability": "equity_only"
},
{
"load_profile": "cold_chain",
"description": "Cold storage/refrigeration — near-constant baseload",
"solar_coincidence_pct": 55,
"diesel_displacement_pct": 64.7,
"pv_capacity_kw": 902.6,
"bess_energy_kwh": 540,
"total_capex_usd": 960792,
"npv_usd": 346492,
"irr_pct": 13.9,
"payback_years": 8,
"annual_savings_usd": 136704,
"co2_saved_tonnes_yr": 544,
"lcoe_usd_kwh": 0.0869,
"dscr_lender_pass": false,
"viability": "marginal"
},
{
"load_profile": "hospital",
"description": "Healthcare facility — 24/7 critical load",
"solar_coincidence_pct": 55,
"diesel_displacement_pct": 65.8,
"pv_capacity_kw": 902.6,
"bess_energy_kwh": 720,
"total_capex_usd": 1022909,
"npv_usd": 295429,
"irr_pct": 13.2,
"payback_years": 8,
"annual_savings_usd": 139078,
"co2_saved_tonnes_yr": 553.4,
"lcoe_usd_kwh": 0.0911,
"dscr_lender_pass": false,
"viability": "marginal"
},
{
"load_profile": "telecoms_tower",
"description": "Telecom base stations — near-constant 24/7 baseload",
"solar_coincidence_pct": 50,
"diesel_displacement_pct": 67,
"pv_capacity_kw": 992.9,
"bess_energy_kwh": 570,
"total_capex_usd": 1048588,
"npv_usd": 293042,
"irr_pct": 13.1,
"payback_years": 8,
"annual_savings_usd": 141417,
"co2_saved_tonnes_yr": 562.8,
"lcoe_usd_kwh": 0.0917,
"dscr_lender_pass": false,
"viability": "marginal"
},
{
"load_profile": "hotel",
"description": "Hospitality — HVAC, kitchen, laundry, lighting",
"solar_coincidence_pct": 55,
"diesel_displacement_pct": 58.9,
"pv_capacity_kw": 902.6,
"bess_energy_kwh": 621.6,
"total_capex_usd": 988952,
"npv_usd": 175667,
"irr_pct": 12,
"payback_years": 9,
"annual_savings_usd": 124334,
"co2_saved_tonnes_yr": 494.8,
"lcoe_usd_kwh": 0.0984,
"dscr_lender_pass": false,
"viability": "marginal"
}
],
"interpretation": "Sectors with high solar coincidence (manufacturing, commercial_office, agro_processing) perform best because PV output directly displaces load without BESS mediation. 24/7 loads (cold_chain, telecoms) require larger BESS to achieve the same displacement and typically need concessional debt terms to clear a 1.30x DSCR threshold.",
"access": "entitled"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30333/sector+market+map+-+country+screen' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"country": "nigeria",
"avg_daily_load_kwh": 2400,
"nameplate_kva": 500,
"load_fraction": 0.75,
"target_diesel_displacement_pct": 70,
"backup_hours_target": 4
}'
{
"status": "success",
"api_version": "1.0.0",
"load_profile": "manufacturing",
"avg_daily_load_kwh": 2400,
"top_country": "South Africa",
"top_country_irr": 50.7,
"top_country_caveat": null,
"irr_leader_country": "South Africa",
"irr_leader_irr": 50.7,
"countries_ranked_by_irr": [
{
"country": "South Africa",
"country_code": "south_africa",
"diesel_price_usd_l": 1.1,
"irradiance_kwh_m2_yr": 1950,
"grid_availability_pct": 65,
"diesel_displacement_pct": 72.9,
"pv_capacity_kw": 621.5,
"bess_energy_kwh": 400,
"total_capex_usd": 671255,
"npv_usd": 2430915,
"irr_pct": 50.7,
"payback_years": 2,
"annual_savings_usd": 279836,
"co2_saved_tonnes_yr": 613,
"lcoe_usd_kwh": 0.0539,
"diesel_allin_usd_kwh": 0.438,
"dscr_lender_pass": true,
"fx_risk_level": "MEDIUM",
"irr_fx_downside_pct": 46.5,
"viability": "excellent"
},
{
"country": "Kenya",
"country_code": "kenya",
"diesel_price_usd_l": 1.05,
"irradiance_kwh_m2_yr": 1750,
"grid_availability_pct": 80,
"diesel_displacement_pct": 72.9,
"pv_capacity_kw": 699.5,
"bess_energy_kwh": 400,
"total_capex_usd": 738188,
"npv_usd": 2060731,
"irr_pct": 36.7,
"payback_years": 3,
"annual_savings_usd": 268400,
"co2_saved_tonnes_yr": 613,
"lcoe_usd_kwh": 0.0592,
"diesel_allin_usd_kwh": 0.4201,
"dscr_lender_pass": true,
"fx_risk_level": "MEDIUM",
"irr_fx_downside_pct": 33.7,
"viability": "excellent"
},
{
"country": "Ghana",
"country_code": "ghana",
"diesel_price_usd_l": 0.95,
"irradiance_kwh_m2_yr": 1800,
"grid_availability_pct": 70,
"diesel_displacement_pct": 72.9,
"pv_capacity_kw": 697.6,
"bess_energy_kwh": 400,
"total_capex_usd": 736616,
"npv_usd": 1811400,
"irr_pct": 33.7,
"payback_years": 4,
"annual_savings_usd": 245528,
"co2_saved_tonnes_yr": 613,
"lcoe_usd_kwh": 0.0591,
"diesel_allin_usd_kwh": 0.3843,
"dscr_lender_pass": true,
"fx_risk_level": "MEDIUM",
"irr_fx_downside_pct": 28.3,
"viability": "excellent"
},
{
"country": "Nigeria",
"country_code": "nigeria",
"diesel_price_usd_l": 0.55,
"irradiance_kwh_m2_yr": 1850,
"grid_availability_pct": 45,
"diesel_displacement_pct": 72.9,
"pv_capacity_kw": 689.5,
"bess_energy_kwh": 400,
"total_capex_usd": 729623,
"npv_usd": 814913,
"irr_pct": 21.3,
"payback_years": 5,
"annual_savings_usd": 154038,
"co2_saved_tonnes_yr": 613,
"lcoe_usd_kwh": 0.0586,
"diesel_allin_usd_kwh": 0.2411,
"dscr_lender_pass": true,
"fx_risk_level": "HIGH",
"irr_fx_downside_pct": 10.1,
"viability": "strong"
}
],
"key_insight": "IRR is primarily driven by diesel price (revenue driver) and grid availability (determines backup need). High diesel + low grid = strongest case. Check FX risk before committing — NGN/ETB volatility can erode returns.",
"access": "unauthenticated"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30334/cross-border+investment+comparison' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"countries": ["nigeria", "south_africa", "kenya", "ghana"],
"load_profile": "manufacturing",
"avg_daily_load_kwh": 2400,
"nameplate_kva": 500,
"load_fraction": 0.75,
"target_diesel_displacement_pct": 70,
"backup_hours_target": 4
}'
{
"ifc_category": "B",
"category_rationale": "Category B — site-specific, largely reversible impacts. Land area 0.5 ha.",
"equator_principles_category": "EP Category B",
"total_requirements": 11,
"checklist": [
{
"performance_standard": "PS1",
"requirement": "Environmental and Social Management System (ESMS)",
"trigger": "always",
"guidance": "Document policies and procedures for identifying/managing E&S risks. ISO 14001 certification acceptable as ESMS. IFC PS1 §14.",
"status": "REQUIRED"
},
{
"performance_standard": "PS1",
"requirement": "Environmental and Social Management Plan (ESMP)",
"trigger": "always",
"guidance": "Project-specific ESMP covering construction, operations, decommissioning. IFC PS1 §25.",
"status": "REQUIRED"
},
{
"performance_standard": "PS1",
"requirement": "Stakeholder Engagement Plan (SEP)",
"trigger": "always",
"guidance": "Community consultation records required. IFC PS1 §25-33. Must document free, prior and informed consultation for affected communities.",
"status": "REQUIRED"
},
{
"performance_standard": "PS1",
"requirement": "Project-level grievance mechanism",
"trigger": "always",
"guidance": "Accessible, transparent mechanism for affected communities. IFC PS1 §35.",
"status": "REQUIRED"
},
{
"performance_standard": "PS2",
"requirement": "Occupational Health and Safety (OHS) plan",
"trigger": "always",
"guidance": "Construction and O&M phase OHS. IFC/World Bank Group EHS Guidelines for Solar PV apply.",
"status": "REQUIRED"
},
{
"performance_standard": "PS2",
"requirement": "Workers accommodation plan",
"trigger": "workers_gt_50",
"guidance": "Required if > 50 construction workers on site simultaneously. IFC PS2 §23-24.",
"status": "REQUIRED"
},
{
"performance_standard": "PS2",
"requirement": "Child and forced labour prohibition — supply chain",
"trigger": "always",
"guidance": "Solar panel supply chain due diligence. Polysilicon sourcing audit recommended given Xinjiang provenance concerns (UFLPA 2022). IFC PS2 §17.",
"status": "REQUIRED"
},
{
"performance_standard": "PS3",
"requirement": "Waste management plan — end-of-life panel disposal",
"trigger": "always",
"guidance": "Solar panel disposal plan at end of 25-yr life. WEEE directive compliance where applicable. LFP BESS: lower hazard than NMC but containment plan required. IFC PS3 §13.",
"status": "REQUIRED"
},
{
"performance_standard": "PS3",
"requirement": "BESS hazardous materials management plan",
"trigger": "bess",
"guidance": "LFP chemistry: lower thermal runaway risk, but spill and fire management plan required. IFC EHS Guidelines for Electric Power Transmission and Distribution.",
"status": "REQUIRED"
},
{
"performance_standard": "PS3",
"requirement": "Construction waste management",
"trigger": "always",
"guidance": "Concrete, steel, cable waste management. Country-specific landfill regulations apply.",
"status": "REQUIRED"
},
{
"performance_standard": "PS6",
"requirement": "Protected area proximity check",
"trigger": "ground_any",
"guidance": "Additional disclosure requirements if within 10 km of IUCN Category I-IV protected area. IFC PS6 §17 and Equator Principles IV Annex B.",
"status": "REQUIRED"
}
],
"dfi_eligibility": [
"AfDB SEFA",
"REPP",
"USAID DCA",
"Proparco",
"IFC",
"FMO"
],
"disclaimer": "This is a pre-screening checklist only. A licensed E&S consultant must conduct the full ESIA/ESMP. Country-specific regulations may impose additional requirements beyond IFC Performance Standards.",
"source": "IFC Performance Standards on Environmental and Social Sustainability (2012). IFC Project 49569 Botswana Solar Phase 2 ESRS (2024) — Category B C&I solar precedent. World Bank Equator Principles IV (2020). AfDB Integrated Safeguards System Category 2 (2013).",
"api_version": "1.0.0",
"access": "unauthenticated"
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30335/ifc+es+pre-screening+checklist?country=nigeria§or=manufacturing&land_ha=0.5&has_bess=true' --header 'Authorization: Bearer YOUR_API_KEY'
{
"irradiance_kwh_m2_yr": null,
"specific_yield_kwh_kwp_yr": 1409.9,
"optimal_tilt_deg": 10,
"optimal_azimuth_deg": 29,
"pvgis_database": "PVGIS-SARAH3",
"coverage_years": "2005–2020 (15-year mean)",
"lat": 6.5244,
"lon": 3.3792,
"source": "EU JRC PVGIS-SARAH3. Huld et al. (2012) Solar Energy 86:1803-1815. Satellite: Meteosat Prime, ~3 km resolution, 15-year average. CrossBoundary (2021) irradiance bias report — site-specific data eliminates systematic +20% overstatement in country-average datasets.",
"access": "unauthenticated"
}
curl --location --request POST 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30336/site-specific+solar+resource+assessment' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"lat": 6.5244,
"lon": 3.3792
}'
{
"countries": [
{
"country_code": "nigeria",
"country_name": "Nigeria",
"irradiance_kwh_m2_yr": 1850,
"grid_availability_pct": 45,
"diesel_price_usd_l": 0.55,
"grid_tariff_usd_kwh": 0.035,
"currency": "NGN",
"fx_volatility_annual_pct": 28,
"ambient_temp_avg_c": 32,
"incentives": {
"pioneer_status": true,
"pioneer_status_years": 3,
"pioneer_cit_rate": 0.3,
"import_duty_solar": 0,
"vat_rate": 0.075,
"carbon_credit_eligible": true
},
"incentive_source": "NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023",
"source_irradiance": "NASA POWER MERRA-2; Fraunhofer ISE PV Report 2024",
"source_diesel": "GIZ HERA (2019); NNPC pump price 2024",
"source_grid": "ESMAP 2023; World Bank Nigeria Power Sector Brief"
},
{
"country_code": "south_africa",
"country_name": "South Africa",
"irradiance_kwh_m2_yr": 1950,
"grid_availability_pct": 65,
"diesel_price_usd_l": 1.1,
"grid_tariff_usd_kwh": 0.135,
"currency": "ZAR",
"fx_volatility_annual_pct": 14,
"ambient_temp_avg_c": 22,
"incentives": {
"section_12b": true,
"corporate_tax_rate": 0.27,
"vat_rate": 0.15,
"carbon_credit_eligible": true
},
"incentive_source": "SA Income Tax Act §12B (Act 58 of 1962, amended 2023)",
"source_irradiance": "PVGIS-SARAH2 (EU JRC); GeoSUN Africa atlas",
"source_diesel": "SAPIA 2024",
"source_grid": "Eskom load-shedding statistics 2024; CSIR energy report"
},
{
"country_code": "kenya",
"country_name": "Kenya",
"irradiance_kwh_m2_yr": 1750,
"grid_availability_pct": 80,
"diesel_price_usd_l": 1.05,
"grid_tariff_usd_kwh": 0.22,
"currency": "KES",
"fx_volatility_annual_pct": 10,
"ambient_temp_avg_c": 24,
"incentives": {
"vat_exempt_solar": true,
"import_duty_solar": 0,
"corporate_tax_rate": 0.3,
"vat_rate": 0.16,
"net_metering": true,
"carbon_credit_eligible": true
},
"incentive_source": "East African VAT Act (2013) Schedule 1; Kenya Energy Act 2019",
"source_irradiance": "PVGIS-SARAH2; Kenya Meteorological Department",
"source_diesel": "EPRA 2024",
"source_grid": "ESMAP 2023; KPLC outage statistics"
},
{
"country_code": "ghana",
"country_name": "Ghana",
"irradiance_kwh_m2_yr": 1800,
"grid_availability_pct": 70,
"diesel_price_usd_l": 0.95,
"grid_tariff_usd_kwh": 0.18,
"currency": "GHS",
"fx_volatility_annual_pct": 18,
"ambient_temp_avg_c": 29,
"incentives": {
"free_zone_exemption": true,
"import_duty_solar": 0,
"corporate_tax_rate": 0.25,
"vat_rate": 0.125,
"carbon_credit_eligible": true
},
"incentive_source": "GIPC Act 2013; Ghana RE Act 832 2011",
"source_irradiance": "PVGIS-SARAH2; Ghana Energy Commission",
"source_diesel": "NPA Ghana 2024",
"source_grid": "ESMAP 2023; GRIDCo"
},
{
"country_code": "egypt",
"country_name": "Egypt",
"irradiance_kwh_m2_yr": 2200,
"grid_availability_pct": 88,
"diesel_price_usd_l": 0.38,
"grid_tariff_usd_kwh": 0.055,
"currency": "EGP",
"fx_volatility_annual_pct": 22,
"ambient_temp_avg_c": 28,
"incentives": {
"free_zone_exemption": true,
"import_duty_solar": 0.02,
"corporate_tax_rate": 0.225,
"vat_rate": 0.05,
"net_metering": true,
"carbon_credit_eligible": true
},
"incentive_source": "Egypt Investment Law 72/2017; NREA Net Metering Decree 2013; reduced 5% VAT rate on renewable energy equipment per Egyptian VAT Law amendments — verify current rate with in-country tax adviser before underwriting.",
"source_irradiance": "PVGIS-SARAH2; NREA Egypt solar atlas",
"source_diesel": "EGPC 2024",
"source_grid": "ESMAP 2023; EETC annual report"
},
{
"country_code": "tanzania",
"country_name": "Tanzania",
"irradiance_kwh_m2_yr": 1900,
"grid_availability_pct": 50,
"diesel_price_usd_l": 1.15,
"grid_tariff_usd_kwh": 0.12,
"currency": "TZS",
"fx_volatility_annual_pct": 8,
"ambient_temp_avg_c": 27,
"incentives": {
"corporate_tax_rate": 0.3,
"vat_rate": 0.18,
"vat_exempt_solar": true,
"import_duty_solar": 0,
"carbon_credit_eligible": true
},
"incentive_source": "Tanzania VAT Act Cap 148; Tanzania Energy Policy 2015",
"source_irradiance": "PVGIS-SARAH2; Tanzania Meteorological Authority",
"source_diesel": "EWURA 2024",
"source_grid": "ESMAP 2023; TANESCO reliability statistics"
},
{
"country_code": "ethiopia",
"country_name": "Ethiopia",
"irradiance_kwh_m2_yr": 1950,
"grid_availability_pct": 55,
"diesel_price_usd_l": 0.7,
"grid_tariff_usd_kwh": 0.04,
"currency": "ETB",
"fx_volatility_annual_pct": 15,
"ambient_temp_avg_c": 25,
"incentives": {
"investment_incentive": true,
"import_duty_solar": 0,
"corporate_tax_rate": 0.3,
"vat_rate": 0.15,
"carbon_credit_eligible": true
},
"incentive_source": "Ethiopia Investment Proclamation 1180/2020",
"source_irradiance": "PVGIS-SARAH2; Ethiopian Meteorological Institute",
"source_diesel": "Ethiopian Petroleum Supply Enterprise 2024",
"source_grid": "ESMAP 2023; EEU statistics"
},
{
"country_code": "zambia",
"country_name": "Zambia",
"irradiance_kwh_m2_yr": 1900,
"grid_availability_pct": 50,
"diesel_price_usd_l": 1.2,
"grid_tariff_usd_kwh": 0.08,
"currency": "ZMW",
"fx_volatility_annual_pct": 20,
"ambient_temp_avg_c": 25,
"incentives": {
"zda_registered": true,
"import_duty_solar": 0,
"corporate_tax_rate": 0.3,
"vat_rate": 0.16,
"carbon_credit_eligible": true
},
"incentive_source": "Zambia Mines and Minerals Development Act; ZDA Act 2006",
"source_irradiance": "PVGIS-SARAH2; ZESCO solar resource data",
"source_diesel": "ERB Zambia 2024",
"source_grid": "ESMAP 2023; ZESCO load-shedding statistics"
},
{
"country_code": "senegal",
"country_name": "Senegal",
"irradiance_kwh_m2_yr": 1900,
"grid_availability_pct": 72,
"diesel_price_usd_l": 1.25,
"grid_tariff_usd_kwh": 0.19,
"currency": "XOF",
"fx_volatility_annual_pct": 4,
"ambient_temp_avg_c": 30,
"incentives": {
"investment_code": true,
"import_duty_solar": 0,
"corporate_tax_rate": 0.3,
"vat_rate": 0.18,
"carbon_credit_eligible": true
},
"incentive_source": "Senegal Investment Code Law 2004-06; CRSE RE regulations",
"source_irradiance": "PVGIS-SARAH2; ASER solar atlas Senegal",
"source_diesel": "SENELEC / SAR pump price 2024",
"source_grid": "ESMAP 2023; SENELEC outage data"
},
{
"country_code": "morocco",
"country_name": "Morocco",
"irradiance_kwh_m2_yr": 2100,
"grid_availability_pct": 92,
"diesel_price_usd_l": 1.05,
"grid_tariff_usd_kwh": 0.13,
"currency": "MAD",
"fx_volatility_annual_pct": 5,
"ambient_temp_avg_c": 22,
"incentives": {
"investment_charter": true,
"net_metering": true,
"import_duty_solar": 0.025,
"corporate_tax_rate": 0.28,
"vat_rate": 0.2,
"carbon_credit_eligible": true
},
"incentive_source": "Morocco Investment Charter 2022; Law 13-09 RE framework",
"source_irradiance": "PVGIS-SARAH2; MASEN",
"source_diesel": "ONHYM 2024",
"source_grid": "ESMAP 2023; ONEE annual report"
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30337/country+risk+and+incentive+data+sheet' --header 'Authorization: Bearer YOUR_API_KEY'
{
"load_profiles": [
{
"profile_code": "manufacturing",
"description": "Heavy industry — motors, compressors, process heat",
"peak_window": "08:00-18:00",
"load_factor": 0.75,
"daily_peak_hours": 10,
"daytime_fraction_pct": 65,
"solar_coincidence_pct": 72,
"bess_benefit_factor": 0.6,
"bess_daily_cycles": 0.8,
"source": "GIZ HERA (2019); RMI Unlocking C&I Solar Nigeria (2024)"
},
{
"profile_code": "commercial_office",
"description": "Office buildings — HVAC, lighting, computers",
"peak_window": "09:00-17:00",
"load_factor": 0.65,
"daily_peak_hours": 9,
"daytime_fraction_pct": 72,
"solar_coincidence_pct": 80,
"bess_benefit_factor": 0.4,
"bess_daily_cycles": 0.6,
"source": "ASHRAE 90.1-2022 commercial load profiles; GIZ HERA"
},
{
"profile_code": "retail_mall",
"description": "Retail/mall — HVAC, lighting, escalators, refrigeration",
"peak_window": "10:00-22:00",
"load_factor": 0.7,
"daily_peak_hours": 14,
"daytime_fraction_pct": 55,
"solar_coincidence_pct": 60,
"bess_benefit_factor": 0.75,
"bess_daily_cycles": 1,
"source": "GIZ HERA (2019); NREL Commercial Building Energy Database"
},
{
"profile_code": "cold_chain",
"description": "Cold storage/refrigeration — near-constant baseload",
"peak_window": "00:00-24:00",
"load_factor": 0.85,
"daily_peak_hours": 24,
"daytime_fraction_pct": 50,
"solar_coincidence_pct": 55,
"bess_benefit_factor": 0.9,
"bess_daily_cycles": 1.1,
"source": "IIR 2022; GIZ HERA"
},
{
"profile_code": "telecoms_tower",
"description": "Telecom base stations — near-constant 24/7 baseload",
"peak_window": "00:00-24:00",
"load_factor": 0.9,
"daily_peak_hours": 24,
"daytime_fraction_pct": 50,
"solar_coincidence_pct": 50,
"bess_benefit_factor": 0.95,
"bess_daily_cycles": 1.2,
"source": "GSMA Green Power for Mobile (2015); IHS Towers energy data"
},
{
"profile_code": "hospital",
"description": "Healthcare facility — 24/7 critical load",
"peak_window": "06:00-22:00",
"load_factor": 0.8,
"daily_peak_hours": 24,
"daytime_fraction_pct": 48,
"solar_coincidence_pct": 55,
"bess_benefit_factor": 1,
"bess_daily_cycles": 1,
"source": "WHO Health Facility Energy Standards; GIZ HERA"
},
{
"profile_code": "hotel",
"description": "Hospitality — HVAC, kitchen, laundry, lighting",
"peak_window": "07:00-23:00",
"load_factor": 0.6,
"daily_peak_hours": 16,
"daytime_fraction_pct": 45,
"solar_coincidence_pct": 55,
"bess_benefit_factor": 0.7,
"bess_daily_cycles": 0.9,
"source": "IFC Hotel Sustainability Baseline (2023); GIZ HERA"
},
{
"profile_code": "agro_processing",
"description": "Agricultural processing — milling, pumping, drying",
"peak_window": "07:00-17:00",
"load_factor": 0.7,
"daily_peak_hours": 10,
"daytime_fraction_pct": 70,
"solar_coincidence_pct": 78,
"bess_benefit_factor": 0.45,
"bess_daily_cycles": 0.5,
"source": "FAO Agro-Processing Energy Handbook (2021); GIZ HERA"
}
],
"interpretation": {
"solar_coincidence_pct": "Fraction of solar output that coincides with load demand. Higher = more direct solar consumption, smaller BESS needed. Manufacturing (72%) is good; cold_chain (55%) is poor — needs more BESS.",
"bess_benefit_factor": "How much BESS improves diesel displacement for this profile. 1.0 = critical (hospital, telecom); 0.4 = BESS adds little value.",
"bess_daily_cycles": "Profile-specific daily cycle rate used to calculate BESS effective life and LCOS. Range 0.5 (agro-processing) to 1.2 (telecoms). Effective life = min(calendar=15yr, 3500 cycles / (cycles/day × 365))."
},
"source": "GIZ HERA (2019); GSMA Green Power for Mobile (2015); ASHRAE 90.1-2022; RMI Africa (2024)"
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30338/sector+load+profile+library' --header 'Authorization: Bearer YOUR_API_KEY'
{
"pv_capex_usd_wdc": {
"small_under_50kw": 1.05,
"medium_50_500kw": 0.9,
"large_500kw_5mw": 0.78,
"utility_over_5mw": 0.68,
"africa_premium_note": "20–30% premium over NREL ATB 2024 US baseline applied for: freight/import duties (~10%), local installation markup (~10%), contingency (~5–10%). Actual quotes vary by country and port logistics.",
"source": "NREL ATB 2024 Commercial PV; Wood Mackenzie Africa Solar (2024)"
},
"bess_capex": {
"pack_cost_usd_kwh": 180,
"bos_cost_usd_kw": 120,
"formula": "CAPEX = (pack_cost × nameplate_kWh) + (BOS_cost × power_kW)",
"chemistry": "LFP (Lithium Iron Phosphate) — dominant Africa C&I 2024",
"lcos_benchmark_usd_mwh": "USD 160–250/MWh (PNNL-33283; BloombergNEF 2024)",
"cycle_note": "BESS effective life uses profile-specific daily cycle rate. Cold-chain and telecoms cycle faster, giving shorter life and higher LCOS.",
"source": "NREL ATB 2024 Storage Appendix; BloombergNEF BESS Price Survey 2024; Mongird et al. (2022) PNNL-33283"
},
"generator_costs": {
"maintenance_usd_kwh": 0.015,
"replacement_usd_kva": 350,
"life_hours": 20000,
"minimum_load_pct": 30,
"wet_stack_warning": "Load < 30% risks wet-stacking — unburnt fuel in exhaust (Cummins 2002)",
"fuel_curve_standard": "ISO 8528-1:2005 §13",
"source": "GIZ HERA (2019); ISO 8528-1:2005; Cummins Power Generation (2002)"
},
"contingency": {
"construction_contingency_pct": 10,
"annual_insurance_pct": 0.5,
"note": "Both included in all /analyse/* CAPEX totals."
}
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30339/capex+benchmark+reference' --header 'Authorization: Bearer YOUR_API_KEY'
{
"title": "Diesel-to-Solar Hybrid Feasibility API — Engineering Methodology v1.0",
"version": "1.0.0",
"modules": [
{
"module": "1. Diesel Baseline",
"method": "ISO 8528-1:2005 §13 two-term load curve: L/hr = 0.084 × P_rated_kW + 0.246 × P_load_kW. All-in cost = fuel + maintenance ($0.015/kWh) + replacement amortisation.",
"sources": [
"ISO 8528-1:2005 §13",
"GIZ HERA (2019)",
"Wood Mackenzie Africa (2022)"
]
},
{
"module": "2. Solar Sizing",
"method": "PV sized so that: solar_coincidence × PV_output / annual_load = target_fraction. Specific yield = PVGIS irradiance × PR=0.78 × thermal_derating_factor. Thermal derating: Pmax_coeff = -0.45%/°C; cell_temp = ambient + 25°C (NOCT). Inverter clipping modelled at DC:AC = 1.20.",
"sources": [
"Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
"PVGIS-SARAH2 (EU JRC)",
"Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
"King et al. (2004) NREL Sandia PV model",
"IEC 61215:2021 §11.5"
]
},
{
"module": "3. BESS Sizing",
"method": "Usable energy = max(backup_target, evening_load × bess_benefit_factor). Nameplate = usable / (DoD × RTE). CAPEX = (pack × nameplate_kWh) + (BOS × power_kW). Effective life = min(calendar_life=15yr, 3500_cycles / (profile_cycles_per_day × 365)). SOH degradation: linear 100% → 80% over effective life.",
"sources": [
"NREL ATB 2024 Storage Appendix",
"Mongird et al. (2022) PNNL-33283 §5.1",
"BloombergNEF BESS Price Survey 2024",
"CATL LFP datasheet"
]
},
{
"module": "4. Dispatch Model",
"method": "HOMER-equivalent annual merit-order: (1) Solar AC → direct load (up to daytime load), (2) Surplus → BESS, (3) BESS → evening/night load, (4) Generator → balance. PV is sized accounting for sector solar coincidence; dispatch uses AC output directly.",
"sources": [
"Lambert et al. (2006) HOMER Energy LLC",
"IEEE Std 1562-2007"
]
},
{
"module": "5. Financial Model",
"method": "25-yr NPV/IRR. Revenue = displaced_kWh × diesel_allin_cost. PV degrades 0.5%/yr. Diesel escalates 3%/yr. O&M 2%/yr. Insurance 0.5%/yr of asset. 10% construction contingency on CAPEX. LCOE = NPV(costs) / NPV(energy_delivered). IRR via bisection. O&M blended rate = weighted average (pv_frac × PV_OM + bess_frac × BESS_OM).",
"sources": [
"IRENA (2023) Renewable Power Generation Costs §4",
"Jordan & Kurtz (2013) NREL/TP-5200-51664",
"IEA Africa Energy Outlook (2023)",
"IFC (2023) Mobilizing Private Investment in Clean Energy Africa"
]
},
{
"module": "6. Tax Incentives",
"method": "SA §12B: capacity-gated — 100% yr-1 depreciation × CIT 27% applies only to solar PV systems at or below 1 MW (nameplate_kva used as a kW proxy); systems above 1 MW, and all non-PV renewable technologies, follow the general §12B(2) 50%/30%/20% three-year schedule instead. Trade-use requirement satisfied by construction — this engine models commercial/industrial load profiles only, never residential. Self-assessed; no discretionary approval required to claim, unlike the two categories below. Nigeria NIPC: 3-yr income tax holiday on net profit (PV of tax savings) — requires pioneer_status_confirmed=true; not applied by default. Kenya: VAT exemption on solar equipment (70% of CAPEX). Ghana Free Zones: 10-yr CIT holiday on net profit — requires free_zone_registered=true; not applied by default. Egypt/Morocco/Zambia: 10-yr accelerated depreciation. Senegal/Ethiopia: investment code accelerated depreciation.",
"sources": [
"SA Income Tax Act §12B(1)(h) and §12B(2) (Act 58 of 1962, amended); SARS draft guide 'Allowances and deductions relating to assets used in the generation of electricity' (30 July 2024)",
"NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023",
"Kenya VAT Act Schedule 1 (East African VAT Act 2013)",
"Ghana Free Zones Act 1995 (Act 504) §26; GIPC Act 2013",
"Egypt Investment Law 72/2017; Morocco Investment Charter 2022"
]
},
{
"module": "7. CO2 and Carbon Credits",
"method": "Diesel saved (litres) = displaced_kWh × ISO 8528-1 fuel curve. CO2 = litres × 2.68 kgCO2/L (IPCC 2006). Carbon revenue = CO2_t × credit_price × (1 - broker_fee). VCS: $12/t; Gold Standard: $15/t; 10% brokerage.",
"sources": [
"IPCC 2006 Guidelines Vol 2 Ch1 Table 1.4",
"EPA GHG Emission Factors Hub (2024)",
"Verra VCS VM0038 v1.0 (2020)",
"Gold Standard AMS-I.D. v18",
"BeZero Carbon Africa pricing Q1 2024"
]
},
{
"module": "8. DSCR Model",
"method": "Debt Service Coverage Ratio = NOI / Annual_Debt_Service. Mortgage-style amortisation. Computed for each year over loan tenor. Minimum DSCR over tenor determines lender bankability (threshold: 1.30). Default terms: 70% LTV, 10-yr, 12% — IFC Africa C&I benchmark. SCOPE: models non-recourse, SPV-style project finance — debt sized and covenanted against isolated project CFADS. Not a corporate/balance-sheet-recourse lending model; corporate lenders underwrite against consolidated financials and credit rating, a different methodology this engine does not implement.",
"sources": [
"IFC (2023) Mobilizing Private Investment in Clean Energy Africa",
"World Bank ESMAP project finance guidelines (2022)"
]
},
{
"module": "9. Sensitivity Analysis",
"method": "One-way sensitivity: diesel price (±20%, +40%), CAPEX (±10%, +20%), NPV at discount rates (8/10/12/15%). IRR is reported as constant across discount rate scenarios — it is a property of cashflows only, independent of discount rate. One variable moved at a time; all others at base.",
"sources": [
"IRENA (2023) risk framework",
"IFC stress-test protocol (2023)"
]
}
],
"verification": {
"diesel_cost": "Cross-check fuel consumption at ISO 8528-1 tables",
"irradiance": "Cross-check at re.jrc.ec.europa.eu/pvg_tools (PVGIS)",
"bess_lcos": "Compare to PNNL-33283 Fig. 4 — LFP range $160–250/MWh",
"pv_capex": "Compare to NREL ATB 2024 atb.nrel.gov Commercial PV mid-case",
"carbon_price": "Check BeZero Carbon Africa report or Xpansiv CBL spot market"
},
"disclaimer": "All outputs are pre-feasibility estimates for site screening, not engineered designs. Commission a licensed electrical engineer (IEC 62548 / NEC 690) and a registered financial adviser before procurement or investment commitment."
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30340/engineering+and+financial+methodology+disclosure' --header 'Authorization: Bearer YOUR_API_KEY'
{
"api_version": "1.0.0",
"release_note": "v1.0.0 initial release. The feature list below documents what the engine does and why, not a sequence of prior public releases — there is no earlier public API version this replaces.",
"features": [
{
"id": "1",
"area": "GPS → PVGIS-SARAH3 irradiance lookup",
"endpoint": "POST /site/irradiance",
"description": "Fetch site-specific annual irradiance from GPS lat/lon using EU JRC PVGIS-SARAH3 (15-year Meteosat satellite data, ~3 km resolution, 2005–2020). CrossBoundary (2021) found generic datasets overstate Africa irradiance by up to 20%, causing 1–2% IRR overstatement. This eliminates that bias. Source: Huld et al. (2012) Solar Energy 86:1803-1815."
},
{
"id": "2",
"area": "PPA / Energy-as-a-Service model",
"endpoint": "POST /analyse/ppa",
"description": "Dual-mode analysis: PPA (developer IRR from tariff cashflows) vs CAPEX ownership. Returns developer IRR, break-even tariff, customer savings vs diesel, 25-year PPA revenue. Template: CrossBoundary EaaS — $707M portfolio, 20 countries. Source: IFC (2023) §3.2; CrossBoundary portfolio data (2025)."
},
{
"id": "3",
"area": "Three-scenario investment analysis",
"endpoint": "POST /analyse/scenarios",
"description": "Conservative (P90 irradiance, diesel −20%, CAPEX +15%) / Base / Optimistic scenarios run in parallel. Returns side-by-side IRR/NPV/DSCR table and investment decision string (INVEST / PROCEED / MARGINAL / DO NOT PROCEED). Source: IRENA (2023) §4.6; IFC stress-test; Arcadis (2025); IEA PVPS Task 13 (2024)."
},
{
"id": "4",
"area": "IFC PS1 E&S pre-screening checklist",
"endpoint": "GET /screen/es-checklist",
"description": "Generates IFC Performance Standards PS1/PS2/PS3/PS6 checklist with IFC project category, Equator Principles category, DFI eligibility list. Required for any Equator Principles or IFC-affiliated DFI financing. Source: IFC PS (2012); IFC Project 49569 ESRS (2024); EP IV (2020)."
},
{
"id": "5",
"area": "DSCR covenant compliance table (all responses)",
"description": "run_hybrid_analysis returns dscr.covenant_table — year-by-year DSCR across the loan tenor with IFC covenant flags (1.30 minimum, 1.20 lock-up, 1.05 default), bankability score, and distribution restriction flags. Assumes non-recourse, SPV-style project finance — see GET /reference/methodology, module 8, for scope. Source: GreenBridge Infrastructure (2025); IFC (2023) §4.3; ESMAP (2022) §6."
},
{
"id": "6",
"area": "Break-even & P90 fields in sensitivity (all responses)",
"description": "sensitivity.breakeven is included in all /analyse/* responses: break-even diesel price, break-even CAPEX overrun %, P90 IRR, P90 NPV, grid tariff crossover. Source: IEA PVPS Task 13 (2024); IRENA (2023) §4.6; Arcadis (2025)."
},
{
"id": "7",
"area": "Discount rate sensitivity — NPV table",
"description": "Discount rate sensitivity reports NPV at 8/10/12/15% alongside IRR. IRR is correctly shown as constant across the sweep — it is a cashflow property independent of discount rate; only NPV varies."
},
{
"id": "8",
"area": "Tax incentives — Ghana, Egypt, Morocco, Zambia",
"description": "Ghana: Free Zones Act §26 model, 10-year CIT holiday on net profit for qualifying Free Zone Enterprise registrations only — zero automatic benefit outside a free zone. Egypt/Morocco/Zambia: investment charter / ZEMA 10-year accelerated depreciation. Source: Ghana Free Zones Act 1995 (Act 504) §26; GIPC Act 2013; Egypt Investment Law 72/2017; Morocco Investment Charter 2022; ZDA Act 2006."
},
{
"id": "9",
"area": "South Africa §12B — capacity-gated tax treatment",
"description": "100% Year-1 write-off applies only to solar PV systems at or below 1 MW. Systems above 1 MW, and non-PV renewable technologies, use the general §12B(2) 50%/30%/20% three-year schedule instead — not a flat rate regardless of size. See GET /reference/methodology, module 6, for the statute citation and disclosed assumptions."
}
],
"engineering_methodology": "See GET /reference/methodology for the full citation list."
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30341/version+history+and+release+notes' --header 'Authorization: Bearer YOUR_API_KEY'
{
"status": "ok",
"api": "Diesel-to-Solar Hybrid Feasibility API",
"version": "1.0.0",
"ts": "2026-08-26T14:16:21Z",
"keep_alive": {
"last_ping_time": "2026-08-26 14:14:38 UTC",
"last_ping_result": "ok_200",
"consecutive_failures": 0
},
"countries_supported": 10,
"sectors_supported": 8,
"new_in_v3": [
"POST /site/irradiance — GPS→PVGIS-SARAH3",
"POST /analyse/ppa — PPA vs CAPEX dual mode",
"POST /analyse/scenarios — 3-scenario IC table",
"GET /screen/es-checklist — IFC PS1 E&S checklist",
"dscr.covenant_table — year-by-year covenant flags in all responses",
"sensitivity.breakeven — P90 IRR/NPV and break-even fields in all responses"
],
"new_in_v3_1": [
"structural_prescreen — BIPV mounting load pre-screen on every analysis response",
"EN 1991-1-4:2005 wind pressure, dead load, ULS combinations, bracket pull-out",
"Seismic, cyclone, high-wind, altitude flags per country",
"Corner Zone F vs central Zone H bracket loads reported separately",
"structural_overrides parameter on /analyse/quick and /analyse/full"
]
}
curl --location --request GET 'https://zylalabs.com/api/12969/diesel+to+solar+hybrid+feasibility+api+-+africa/30342/system+status+and+health+monitor' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Diesel to Solar Hybrid Feasibility API - Africa simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
Lender-grade solar+BESS pre-feasibility for African C&I. IRR, DSCR, sensitivity, carbon credits.
The Quick Analysis endpoint returns a comprehensive pre-feasibility analysis for diesel-to-solar hybrid projects, including metrics such as IRR, NPV, payback period, DSCR bankability, optimal solar and battery sizing, carbon credit revenue, and FX risk.
Key fields in the response include `irr_pct` (internal rate of return), `payback_years` (time to recover investment), `lcoe_solar_bess_usd_kwh` (levelized cost of energy), `diesel_allin_usd_kwh` (cost of diesel), `dscr_lender_pass` (DSCR compliance), and `co2_saved_tonnes_yr` (annual CO2 savings).
Users can customize their requests by providing parameters such as site location, diesel generator specifications, expected load profiles, and local diesel prices. These parameters help tailor the analysis to specific project conditions.
The response data is structured in a JSON format, with a `summary` object containing key financial and environmental metrics. This organization allows users to easily access and interpret the results of the analysis.
The API utilizes reputable sources such as ISO 8528-1 for diesel generator fuel curves, NREL ATB 2024 for solar and battery CAPEX benchmarks, and IFC project finance standards for bankability scoring, ensuring high data quality and reliability.
Typical use cases include feasibility studies for energy developers, financial assessments for lenders, and project evaluations for corporate energy buyers. The API streamlines the analysis process, enabling quick decision-making.
Users can leverage the returned data to assess project viability, compare financing options, and prepare documentation for credit committees. The detailed metrics help inform investment decisions and project planning.
Data accuracy is maintained through the use of established engineering and financial standards, regular updates from reliable sources, and rigorous validation processes to ensure that calculations reflect real-world conditions.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund