> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datanumia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Example

## Input

```json theme={null}
{
  "input": {
    "HOUSING_ZIP_CODE": "92110",
    "COUNTRY": "FRANCE",
    "HOUSING_CONSTRUCTION_YEAR": 1950,
    "HOUSING_SANITARY_HOT_WATER_MANAGEMENT": true,
    "HOUSING_SANITARY_HOT_WATER_PRODUCTION_SYSTEM_ENERGY_SOURCE": "ELECTRICITY",
    "HOUSING_INSULATION_LEVEL": "OLD_BUILDING",
    "HOUSING_SUBSCRIBED_POWER": 6,
    "HOUSING_TYPE": "APARTMENT",
    "HOUSING_TOTAL_SURFACE": 35,
    "HOUSING_RESIDENCE_TYPE": "MAIN",
    "HOUSING_OCCUPATION_STATUS": "OWNER",
    "HOUSING_ELECTRIC_CONNECTION": "SINGLE_PHASE",
    "HOUSING_LAST_YEAR_ELECTRICITY_CONSUMPTION": 3300,
    "HOUSING_PRINCIPAL_HEATING_DISTRIBUTION_SYSTEM": "RADIATOR",
    "HOUSING_ROOF_RENOVATED": false,
    "HOUSING_WALL_RENOVATED": false,
    "HOUSING_WINDOWS_RENOVATED": false,
    "VEHICLE_TYPE": "NONE",
    "MECHANICAL_VENTILATION_SYSTEM_TYPE": "NONE"
  }
}
```

## Output

```json theme={null}
{
  "advices": {
    "AIR_AIR_HEAT_PUMP_INSTALLATION": {
      "eligibility": true,
      "score": 0.6868757764,
      "simulationsAssumptions": {},
      "bestSimulation": {
        "AIR_AIR_HEAT_PUMP_COP": {
          "method": "HPC_02",
          "source": "CALCULATION",
          "value": 4.000,
          "unit": "N/A"
        },
        "AIR_AIR_HEAT_PUMP_COP_REFINED": {
          "method": "HPCR_01",
          "source": "CALCULATION",
          "value": 4.24674440759774805315800000,
          "unit": "N/A"
        },
        "AIR_AIR_HEAT_PUMP_SIMULATION_SCORE": {
          "method": "AAHPSS_01",
          "source": "CALCULATION",
          "value": 0.6868757764,
          "unit": "N/A"
        },
        "AIR_AIR_HEAT_PUMP": {
          "method": "HP_01",
          "source": "CALCULATION",
          "value": {
            "id": 2,
            "brand": "Toshiba",
            "model": "Naka",
            "reference": "RAS-B07B2KVG-E RAS-07B2AVG-E",
            "cop": 3.910,
            "scop": 4.000,
            "seer": 6.100,
            "electricConnection": "SINGLE_PHASE",
            "heatingPower": 2.500,
            "outdoorSoundPowerLevel": 61,
            "indoorSoundPowerLevel": 52,
            "installer": "IZI",
            "productPrice": 1835.00,
            "installationCost": 1049.00,
            "type": "Mono/Multisplit",
            "totalCost": 2884.00
          },
          "unit": "N/A"
        },
        "AMORTIZATION": {
          "method": "A_01",
          "source": "CALCULATION",
          "value": {
            "duration": "P0Y0MT",
            "start": "2025-04",
            "end": "2025-04"
          },
          "unit": "N/A"
        },
        "AVERAGE_COOLING_DEGREE_DAY": {
          "method": "ACDD_01",
          "source": "CALCULATION",
          "value": 1.0532608695652173,
          "unit": "N/A"
        },
        "CUSTOMER_AFFINITY": {
          "method": "CA_01",
          "source": "CALCULATION",
          "value": "INVESTMENT",
          "unit": "N/A"
        },
        "HEAT_PUMP_REQUIRED_ELECTRICITY_POWER": {
          "method": "HPREP_01",
          "source": "CALCULATION",
          "value": 0.6964158226,
          "unit": "kW"
        },
        "HEAT_PUMP_YEARLY_CO2_EMISSIONS": {
          "method": "HPYCE_01",
          "source": "CALCULATION",
          "value": 42.4277947308644,
          "unit": "kg"
        },
        "HEAT_PUMP_YEARLY_CONSUMPTION": {
          "method": "HPYC_02",
          "source": "CALCULATION",
          "value": 815.9191294397,
          "unit": "kWh"
        },
        "HEAT_PUMP_YEARLY_CONSUMPTION_COST": {
          "method": "HPYCC_01",
          "source": "CALCULATION",
          "value": 197.69720506323931,
          "unit": "€"
        },
        "HEAT_PUMP_YEARLY_CONSUMPTION_COST_AVERAGE": {
          "method": "HPYCCA_01",
          "source": "CALCULATION",
          "value": 322.9944382358,
          "unit": "€"
        },
        "HEAT_PUMP_YEARLY_CONSUMPTION_COST_EVOLUTION": {
          "method": "HPYCCE_01",
          "source": "CALCULATION",
          "value": {
            "0": 197.6972050632,
            "1": 210.1521289822,
            "2": 223.3917131081,
            "3": 237.4653910339,
            "4": 252.4257106690,
            "5": 268.3285304411,
            "6": 285.2332278589,
            "7": 296.6425569733,
            "8": 308.5082592522,
            "9": 320.8485896223,
            "10": 333.6825332072,
            "11": 347.0298345355,
            "12": 357.4407295716,
            "13": 368.1639514587,
            "14": 379.2088700025,
            "15": 390.5851361026,
            "16": 402.3026901857,
            "17": 414.3717708913,
            "18": 426.8029240180,
            "19": 439.6070117385
          },
          "unit": "N/A"
        },
        "INVESTMENT_PLAN": {
          "method": "IP_01",
          "source": "CALCULATION",
          "value": [
            {
              "investmentDuration": "P0Y0MT",
              "amortizedAmount": 0,
              "remainingAmountDue": 2884.00,
              "amortizedRate": 0,
              "moneySaving": 0,
              "amortized": false,
              "month": "202
```