Solaris Africa Hybrid Feasibility API

API ID 13379

Engineering-grade API for rapid solar, battery, diesel hybrid feasibility, financial modelling and lender-ready project screening across African commercial & industrial markets.

288 ms avg response

API Documentation

Endpoints

Request
Single-site diesel-to-solar pre-feasibility screen: optimized PV+BESS sizing, dispatch sequence, NPV/IRR/payback, DSCR compliance flag, carbon credit yield, and generator thermal health — without the full 25-year cashflow schedule. Built for fast top-of-funnel qualification. DSCR/covenant results assume non-recourse, SPV-style project finance and are not a bankability verdict for corporate-recourse lending.
Endpoint ID: 28562
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28562/pre-feasibility+screening+report
INPUT PARAMETERS

Pre-Feasibility Screening Report — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Pre-Feasibility Screening Report — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28562/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
}'

    
Request
Institutional underwriting model with a full 25-year annual cashflow schedule, non-linear BESS state-of-health degradation, configurable debt structure (tenor, interest rate, gearing), DSCR covenant table, and carbon registry accounting — the complete engineering-and-finance package a lender's credit committee expects. Scope: models non-recourse, SPV-style project finance (debt sized and covenanted against isolated project CFADS) — not a corporate/balance-sheet-recourse lending methodology. South Africa §12B tax treatment is capacity-gated per statute, not a flat rate. carbon_standard is not retrieved from any endpoint — it's an optional field accepting exactly two fixed values: "vcs" (Verra VCS VM0038, the default if omitted) or "gold_standard" (Gold Standard AMS-I.D., which carries a price premium over VCS). Pick whichever registry you intend to certify credits under; there's nothing to look up.
Endpoint ID: 28563
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28563/lender-grade+full+underwriting+model
INPUT PARAMETERS

Lender-Grade Full Underwriting Model — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Lender-Grade Full Underwriting Model — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28563/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"
}'

    
Request
Runs up to 30 sites in one call and returns each ranked by IRR, alongside totalized portfolio metrics — aggregate CAPEX, blended carbon revenue, DSCR pass/fail counts, and validation errors — for developers or funds screening a multi-site pipeline at once. Each site's DSCR pass/fail assumes non-recourse, SPV-style project finance per site, not consolidated corporate-recourse debt. site_id is not retrieved from any endpoint — it's a label you choose yourself for each site in the request (e.g. "factory_ZA_001", "tower_NG_014"). It's used only to match that site's results back to the site you sent; it isn't validated against any list or registry, so any non-empty string works.
Endpoint ID: 28755
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28755/portfolio+screening+and+fleet+ranking+report
INPUT PARAMETERS

Portfolio Screening and Fleet Ranking Report — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Portfolio Screening and Fleet Ranking Report — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28755/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
}'

    
Request
Structured 8-section data package — executive summary, country economic context, engineering design, financial ledger, debt structuring, risk register, ESG metrics, and source citations — pre-formatted for headless PDF generation (ReportLab, WeasyPrint, Puppeteer) into a client-ready feasibility report. Debt structuring and covenant sections assume non-recourse, SPV-style project finance, not corporate-recourse lending. Country tax-incentive treatment is statute-specific and eligibility-gated, disclosed per country in Section 2. carbon_standard is not retrieved from any endpoint — it's an optional field accepting exactly two fixed values: "vcs" (Verra VCS VM0038, the default if omitted) or "gold_standard" (Gold Standard AMS-I.D., which carries a price premium over VCS). Pick whichever registry you intend to certify credits under; there's nothing to look up.
Endpoint ID: 28756
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28756/bankable+lender+package+8-section+report+data
INPUT PARAMETERS

Bankable Lender Package 8-Section Report Data — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "report_type": "bankable_pre_feasibility",
    "generated_at": "2026-08-03T19:02:25Z",
    "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"
}
Bankable Lender Package 8-Section Report Data — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28756/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
}'

    
Request
Dual-mode developer-vs-customer model for zero-CAPEX Power Purchase Agreement structures: developer project IRR from tariff cashflows, customer year-1 savings, and the break-even PPA tariff solved via bisection at the developer's WACC — for structuring EaaS offers instead of direct asset sales.
Endpoint ID: 28757
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28757/ppa+energy-as-a-service+deal+model
INPUT PARAMETERS

PPA Energy-as-a-Service Deal Model — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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."
}
PPA Energy-as-a-Service Deal Model — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28757/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
}'

    
Request
Parallel Conservative (P90 yield, diesel −20%, CAPEX +15%) / Base / Optimistic scenario run, returning side-by-side IRR/NPV/DSCR and a standardized investment decision tag (INVEST / PROCEED WITH CONDITIONS / MARGINAL / DO NOT PROCEED) — the exact comparison table an investment committee reviews before approving capital. DSCR results across all three scenarios assume non-recourse, SPV-style project finance.
Endpoint ID: 28758
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28758/investment+committee+stress-test+matrix
INPUT PARAMETERS

Investment Committee Stress-Test Matrix — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Investment Committee Stress-Test Matrix — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28758/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
}'

    
Request
Runs all 8 sector load profiles against one country in a single call and ranks them by financial performance, flagging the top recommendation by IRR and project-finance DSCR pass rate (non-recourse, SPV-style project finance) — for identifying which industry vertical to target first in a new market.
Endpoint ID: 28759
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28759/sector+market+map+-+country+screen
INPUT PARAMETERS

Sector Market Map - Country Screen — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Sector Market Map - Country Screen — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28759/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
}'

    
Request
Compares the same load profile across 2–10 countries side-by-side — fuel baselines, grid reliability risk, sovereign tax incentives, FX volatility — for developers deciding which national market to enter first.
Endpoint ID: 28760
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28760/cross-border+investment+comparison
INPUT PARAMETERS

Cross-Border Investment Comparison — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Cross-Border Investment Comparison — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28760/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
}'

    
Request
Generates an IFC Performance Standards (PS1/PS2/PS3/PS6) pre-screening checklist — project category (A/B), Equator Principles tier, and DFI eligibility list — required documentation for any Equator Principles bank or IFC-affiliated lender.
Endpoint ID: 28761
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28761/ifc+es+pre-screening+checklist
INPUT PARAMETERS

IFC ES Pre-Screening Checklist — Endpoint Features

Object Description
country Required Country code to screen, e.g. nigeria
sector Required Sector/load profile to check, e.g. manufacturing
land_ha Optional Estimated land area in hectares
has_bess Optional Does the project include a BESS?
request_body Required
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

country
sector
land_ha
has_bess
API EXAMPLE RESPONSE
JSON
{
    "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"
}
IFC ES Pre-Screening Checklist — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28761/ifc+es+pre-screening+checklist?country=nigeria§or=manufacturing&land_ha=0.5&has_bess=true' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw ''

    
Request
Converts GPS coordinates into site-specific annual solar irradiance via EU JRC PVGIS-SARAH3 satellite data, correcting the up-to-20% overstatement generic country-average datasets produce — feed the result into the full underwriting model for site-accurate sizing.
Endpoint ID: 28762
POST https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28762/site-specific+solar+resource+assessment
INPUT PARAMETERS

Site-Specific Solar Resource Assessment — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Site-Specific Solar Resource Assessment — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28762/site-specific+solar+resource+assessment' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "lat": 6.5244,
  "lon": 3.3792
}'

    
Request
Localized reference data per country — solar irradiance baseline, fuel prices, grid reliability rating, and sovereign tax incentive regime — the source data every calculation is benchmarked against.
Endpoint ID: 28763
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28763/country+risk+and+incentive+data+sheet
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "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"
}
Country Risk and Incentive Data Sheet — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28763/country+risk+and+incentive+data+sheet' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Hourly load-shape library for all 8 supported sectors — solar coincidence curves, expected BESS cycling behavior, and peak demand windows — for validating inputs before running a full analysis.
Endpoint ID: 28764
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28764/sector+load+profile+library
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "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)"
}
Sector Load Profile Library — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28764/sector+load+profile+library' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Baseline system CAPEX benchmarks for PV arrays, battery storage, and backup integration costs sourced from NREL ATB — for sense-checking quoted installer pricing against market rates.
Endpoint ID: 28765
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28765/capex+benchmark+reference
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "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."
    }
}
CAPEX Benchmark Reference — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28765/capex+benchmark+reference' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Full technical disclosure of every calculation module and its governing standard — dispatch logic, degradation curves, DSCR methodology, carbon accounting — with primary source citations, for due-diligence teams auditing the model.
Endpoint ID: 28766
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28766/engineering+and+financial+methodology+disclosure
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "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."
}
Engineering and Financial Methodology Disclosure — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28766/engineering+and+financial+methodology+disclosure' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Version history of the calculation engine, confirming backward compatibility and documenting what changed in each release — for integrators tracking API stability over time.
Endpoint ID: 28767
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28767/version+history+and+release+notes
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "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."
}
Version History and Release Notes — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28767/version+history+and+release+notes' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the API's operational status, current version number, and the list of countries and sectors currently supported. Use this to confirm the API is reachable before sending analysis requests, or for uptime monitoring.
Endpoint ID: 28768
GET https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28768/system+status+and+health+monitor
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "status": "ok",
    "api": "Diesel-to-Solar Hybrid Feasibility API",
    "version": "1.0.0",
    "ts": "2026-08-03T18:19:43Z",
    "keep_alive": {
        "last_ping_time": "2026-08-03 18:19:42 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"
    ]
}
System Status And Health Monitor — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13379/solaris+africa+hybrid+feasibility+api/28768/system+status+and+health+monitor' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

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 Solaris Africa Hybrid Feasibility API simply include your bearer token in the Authorization header.

Headers
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.

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Engineering-grade API for rapid solar, battery, diesel hybrid feasibility, financial modelling and lender-ready project screening across African commercial & industrial markets.

Solaris Africa Hybrid Feasibility API FAQs

Each endpoint returns structured data related to solar hybrid feasibility, including financial metrics, emissions reductions, and engineering assessments. For example, the Quick Solar Hybrid Feasibility Analysis returns metrics like average daily load, diesel displacement percentage, and financial performance indicators such as DSCR and IRR.

Key fields include "status," "api_version," "input" (user parameters), "country_context" (local conditions), and "diesel_baseline" (costs and consumption). For instance, the Full Lender Grade Hybrid Analysis includes cashflow details and investment metrics like NPV and payback years.

Parameters vary by endpoint but generally include "country," "load_profile," "avg_daily_load_kwh," and "target_displacement_pct." Users can customize requests by adjusting these parameters to reflect specific project requirements, such as load profiles for different industries.

Response data is organized in a JSON format, with sections for input parameters, country context, and analysis results. Each section is clearly labeled, allowing users to easily locate specific information, such as financial metrics or environmental impact data.

Data sources include reputable organizations and studies, such as NASA POWER, GIZ HERA, and NREL. Each endpoint's response often cites these sources, ensuring transparency and reliability in the data used for calculations and assessments.

Typical use cases include feasibility assessments for solar hybrid projects, financial modeling for investors, and portfolio screening for developers. Users can leverage the data to evaluate project viability, compare different sites, or structure Power Purchase Agreements.

Users can analyze the returned data to make informed decisions about project investments, assess financial viability, and identify potential risks. For example, understanding the DSCR and IRR can help determine the bankability of a project before proceeding with detailed engineering.

Data accuracy is maintained through the use of established methodologies and standards, such as ISO guidelines and peer-reviewed sources. Regular updates and quality checks ensure that the data reflects current market conditions and technological advancements.

General FAQs

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.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

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.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

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.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs