{
"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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Diesel to Solar Hybrid Feasibility API - Africa basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Lender-grade solar+BESS pre-feasibility for African C&I. IRR, DSCR, sensitivity, carbon credits.
O endpoint de Análise Rápida retorna uma análise de pré-viabilidade abrangente para projetos híbridos de diesel e solar, incluindo métricas como TIR, VPL, período de payback, viabilidade bancária do DSCR, dimensionamento otimizado de solar e bateria, receita de créditos de carbono e risco cambial
Os campos chave na resposta incluem `irr_pct` (taxa interna de retorno), `payback_years` (tempo para recuperar o investimento), `lcoe_solar_bess_usd_kwh` (custo nivelado de energia), `diesel_allin_usd_kwh` (custo do diesel), `dscr_lender_pass` (conformidade do DSCR) e `co2_saved_tonnes_yr` (economia anual de CO2)
Os usuários podem personalizar suas solicitações fornecendo parâmetros como localização do site, especificações do gerador a diesel, perfis de carga esperados e preços locais do diesel Esses parâmetros ajudam a adaptar a análise às condições específicas do projeto
Os dados da resposta estão estruturados em um formato JSON com um objeto `summary` contendo métricas financeiras e ambientais chave Essa organização permite que os usuários acessem e interpretem facilmente os resultados da análise
A API utiliza fontes respeitáveis como a ISO 8528-1 para curvas de combustível de geradores a diesel NREL ATB 2024 para benchmarks de CAPEX de energia solar e baterias e padrões de financiamento de projetos da IFC para pontuação de viabilidade garantindo alta qualidade e confiabilidade dos dados
Casos de uso típicos incluem estudos de viabilidade para desenvolvedores de energia, avaliações financeiras para credores e avaliações de projetos para compradores corporativos de energia A API agiliza o processo de análise permitindo a tomada de decisão rápida
Os usuários podem aproveitar os dados retornados para avaliar a viabilidade do projeto, comparar opções de financiamento e preparar documentação para comitês de crédito As métricas detalhadas ajudam a informar decisões de investimento e planejamento de projetos
A precisão dos dados é mantida através do uso de padrões de engenharia e financeiros estabelecidos atualizações regulares de fontes confiáveis e processos rigorosos de validação para garantir que os cálculos reflitam as condições do mundo real