Download OpenAPI specification:
Bienvenue dans la documentation de l'API kelvin. Cette API est conçue pour évaluer et améliorer la performance énergétique des propriétés.
L'API kelvin vous permet de créer des simulations pour évaluer la performance énergétique d'un bien immobilier. Elle vous aide également à proposer des plans de travaux personnalisés pour optimiser l'efficacité énergétique de ces biens.
Pour créer une simulation, il faut déterminer la latitude, la longitude et l'identifiant d'interopérabilité (ban_id) de la propriété. Une carte interactive est disponible pour faciliter cette tâche: L'iframe de sélection de polygone. Cette carte permet aux utilisateurs de sélectionner visuellement leur propriété sur une carte. Vous pouvez intégrer ce composant dans vos applications en suivant la documentation de l'iframe de sélection de polygone.
Utilisez cette documentation pour explorer les endpoints disponibles, comprendre les paramètres requis, et découvrir comment intégrer efficacement l'API dans votre système.
Tous les endpoints ont été migrés de /api/v2/ vers /api/v3/.
dpe_class est renommé energy_rating dans l'état initial et l'état projeté. Trois nouveaux champs obligatoires sont ajoutés :
| Avant | Après |
|---|---|
dpe_class |
energy_rating |
| (absent) | energy_consumption (kWh/m²/an) |
| (absent) | carbon_rating (lettre GES A–G) |
| (absent) | carbon_emissions (kg CO₂/m²/an) |
Les champs walls_insulation_level, windows_insulation_level, high_floor_insulation_level, low_floor_insulation_level (chaînes de caractères) sont remplacés par des objets contenant un level et une u_value numérique (W/m²K) :
"walls_insulation": { "level": "partially_insulated", "u_value": 0.35 }
subsidies (montant total unique) est remplacé par un objet financial_support détaillé, disponible à la fois sur chaque plan de rénovation et sur chaque poste de travaux :
"financial_support": { "mpr": 4000.0, "cee": 800.0, "ecoptz": 1200.0, "local": { "Aide région Île-de-France": 1500.0 } }
Chaque catégorie de travaux dans renovation_plan est désormais un tableau d'items (au lieu d'un objet unique). Chaque item remplace id/simplified_id/label par technical_id et name.
Plusieurs champs ont des valeurs d'enum entièrement révisées pour correspondre au référentiel DPE/ADEME :
generator_type / secondary_generator_type : 4 valeurs génériques → 26 valeurs précises (ex. condensing_gas_boiler, air_to_water_heat_pump, pellet_stove) + unknown pour les cas non identifiéshot_water_type : 5 valeurs → 24 valeurs précises (ex. electric_hot_water_tank, thermodynamic_water_tank) + unknown pour les cas non identifiésgenerator_energy / hot_water_energy / secondary_generator_energy : urban_heating_or_biomass → district_heating + biomass_wood + others + unknownwall_material : 5 valeurs → 9 valeurs (ex. lightweight_concrete, hollow_or_perforated_bricks, rammed_or_cob_earth)vents_type : codes renommés (ex. vmc_sf_hygro_b → sf_hygro_b_vmc)windows renommé en doors_windows dans renovation_planLa catégorie windows couvre désormais fenêtres, portes, portes-fenêtres et fenêtres de toit (18 valeurs de technical_id).
recently_renovated — supprimé de l'état initial et de l'endpoint de mise à jour du logementhas_vents — supprimé (remplacé par le champ vents_type)subsidies — remplacé par l'objet financial_supportPUT /api/v3/simulations/{id}/qualification — Enregistre le profil de qualification de l'utilisateur (statut propriétaire/locataire, taille du foyer, tranche de revenus, département fiscal, maturité du projet). Cet appel doit être effectué avant POST /run.
epc_id — numéro du DPE attaché à la simulation, le cas échéantsecondary_generator_type / secondary_generator_energy — système de chauffage secondairecollective_heating / collective_hot_water — indicateurs de systèmes collectifshigh_floor_surface, low_floor_surface, windows_surface — surfaces en m²high_floor_kinds / low_floor_kinds — tableaux remplaçant les anciens high_floor_type / low_floor_typesources — indique pour chaque champ si la valeur provient de ai, user ou dperenovation_planEn plus de ventilation, walls, doors_windows, low_floor, high_floor, les catégories suivantes sont désormais retournées :
heating, hot_water, renewable_energy, summer_comfort, winter_comfort, thermal_bridge_treatment, lighting, sobriety
Chaque plan de rénovation inclut désormais un objet kpi avec property_value_increase (valorisation immobilière estimée exprimée en pourcentage, en €/m² et en perte de surface m²).
Endpoint pour créer une simulation à partir d'un ban_id et des coordonnées GPS.
| latitude required | number |
| longitude required | number |
| ban_id | string |
{- "latitude": 43.53718,
- "longitude": 1.337797,
- "ban_id": "31157_0790_00009"
}{- "simulation_id": "hjjcm1qp28"
}Les informations de la propriété.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
{- "status": "completed",
- "housing": {
- "housing_type": "apartment",
- "epc_id": "2331E2555868X",
- "surface": 100,
- "floor_level": "ground",
- "number_of_exterior_wall": 1
}, - "address": {
- "street_number": "123",
- "address_line_1": "Rue de la Paix",
- "address_line_2": "Apt 4B",
- "city": "Paris",
- "postal_code": "75000",
- "country_number": 250,
- "latitude": 43.53718,
- "longitude": 1.337797
}
}Endpoint pour mettre à jour les informations de la propriété
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
| epc_id | string Le numéro unique du DPE. |
| housing_type | string Enum: "house" "apartment" Le type de propriété. |
| surface | integer La surface de la propriété en m2. Obligatoire si le housing_type est apartment. |
| floor_level | string Enum: "ground" "intermediate" "last" La position da le propriété dans l'immeuble. Obligatoire si le housing_type est apartment. |
| number_of_exterior_wall | integer Le nombre de murs donnant sur l'extérieur. Obligatoire si le housing_type est apartment. |
{- "epc_id": "2331E2555868X",
- "housing_type": "apartment",
- "surface": 100,
- "floor_level": "ground",
- "number_of_exterior_wall": 1
}{- "error": "Housing type is missing or invalid"
}Enregistre les informations de qualification du profil utilisateur.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation |
| profile required | string Enum: "owner_resident" "owner_non_resident" "renter" "lessor" Le profil de l'utilisateur. |
| primary_residence | boolean Indique si c'est une résidence principale. |
| household_size required | number Nombre de personnes dans le foyer. |
| tax_residence_department | string Département de résidence fiscale. |
| income_range required | string Enum: "very_modest" "modest" "intermediate" "superior" La tranche de revenus du foyer. |
| project_maturity | string Enum: "curious" "searching" "estimated" "signed" Maturité du projet. |
{- "profile": "owner_resident",
- "primary_residence": true,
- "household_size": 4,
- "tax_residence_department": "75",
- "income_range": "modest",
- "project_maturity": "curious"
}{- "error": "Invalid request parameters"
}Les informations de l'état projeté.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
{- "status": "completed",
- "projected_state": {
- "renovation_plans": [
- {
- "id": "hjjcm1qp28",
- "name": "Mon plan personnalisé",
- "type": "customized",
- "energy_rating": "B",
- "energy_consumption": 201,
- "carbon_rating": "C",
- "carbon_emissions": 40,
- "yearly_energy_savings": 600,
- "yearly_energy_cost": 12000,
- "budget": 12000,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}, - "kpi": {
- "property_value_increase": {
- "percentage": 5,
- "price_per_sqm": 115,
- "area_loss_sqm": 0
}
}, - "renovation_plan": {
- "ventilation": [
- {
- "technical_id": "dual_flow_ventilation",
- "name": "Installation d'une VMC double flux",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "walls": [
- {
- "technical_id": "exterior_thermal_correction",
- "name": "Réalisation d'une correction thermique par l'extérieur",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "doors_windows": [
- {
- "technical_id": "windows_triple_glazed",
- "name": "Pose de fenêtres à triple vitrage",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "low_floor": [
- {
- "technical_id": "crawl_space",
- "name": "Isolation du plancher bas sur vide sanitaire",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "high_floor": [
- {
- "technical_id": "sloped_walls_nonreg",
- "name": "Isolation non réglementaire des rampants de toiture",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "heating": [
- {
- "technical_id": "wood_pellets_stove",
- "name": "Installation d'un poêle à granulés",
- "quantity": 0,
- "energy": {
- "technical_id": "electricity",
- "name": "Électricité"
}, - "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}, - "recommended_power": 6.2,
- "recommended_water_tank_volume": 80
}
], - "hot_water": [
- {
- "technical_id": "solar_water_heater",
- "name": "Installation d'un chauffe-eau solaire individuel",
- "quantity": 0,
- "energy": {
- "technical_id": "electricity",
- "name": "Électricité"
}, - "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "renewable_energy": [
- {
- "technical_id": "hydroelectric_turbine",
- "name": "Installation d'une micro-turbine hydroélectrique",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "summer_comfort": [
- {
- "technical_id": "sunshade",
- "name": "Installation de brise-soleil",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "winter_comfort": [
- {
- "technical_id": "thermal_curtains",
- "name": "Installation de rideaux thermiques",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "thermal_bridge_treatment": [
- {
- "technical_id": "thermal_bridge_treatment_after_interior_insulation",
- "name": "Traitement d'une rupture de pont thermique suite à une isolation des murs par l'intérieur",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "lighting": [
- {
- "technical_id": "led_low_consumption_bulbs",
- "name": "Remplacement d'ampoules existantes par des lampes LED à faible consommation",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "sobriety": [
- {
- "technical_id": "rainwater_watering_system",
- "name": "Installation d'un système d'arrosage utilisant l'eau de récupération",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
]
}
}
]
}
}Cet endpoint permet de rechercher des DPE par clé d'interopérabilité ou par numéro de DPE.
Fonctionnalités : Il est obligatoire de fournir au moins un des deux paramètres "ban_id" ou "dpe_id".
Filtres : En plus des paramètres principaux, cet endpoint permet d'appliquer des filtres supplémentaires :
Réponse : En cas de succès, l'endpoint retourne une liste de DPE correspondant aux critères de recherche spécifiés.
| dpe_id | string Example: dpe_id=2331E2555868X |
| building_type | string Enum: "apartment" "house" "building" "unknown" Example: building_type=house Le type de bâtiment:
|
| ban_id | string Example: ban_id=31157_0790_00009 |
| surface | number Example: surface=100 |
| report_date | string Example: report_date=2024-01-01 |
| energy_class | string Example: energy_class=E |
[- {
- "dpe_id": "2331E2555868X",
- "building_type": "house",
- "ban_id": "31157_0790_00009",
- "energy_class": "A",
- "emission_class": "B",
- "surface": 100,
- "report_date": "2024-05-10",
- "address": "9 Rue du Vivier, Cugnaux, 31270",
- "address_complement": "Escalier: Etage 3; Porte 322, Lot: 10",
- "dpe_version": "2.4"
}
]Les informations de l'état initial.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
{- "status": "completed",
- "initial_state": {
- "energy_rating": "B",
- "energy_consumption": 201,
- "carbon_rating": "C",
- "carbon_emissions": 40,
- "epc_id": "2169E0063000A",
- "confidence_score": 0.85,
- "annual_energy_cost_range": {
- "min": 500,
- "max": 1200
}, - "annual_energy_consumption": 150,
- "position_percentage_neighborhood": 0.75,
- "energy_loss_percentage": {
- "walls": 0.15,
- "openings": 0.2,
- "low_floor": 0.3,
- "high_floor": 0.35
}, - "close_to_historical_monument": false,
- "living_area": 120,
- "exterior_walls_surface": 100,
- "house_number_of_levels": 1,
- "shared_walls": true,
- "wall_material": "brick",
- "construction_year": 1985,
- "number_of_windows": 8,
- "generator_type": "condensing_gas_boiler",
- "generator_energy": "gas",
- "hot_water_type": "electric_hot_water_tank",
- "hot_water_energy": "electricity",
- "walls_insulation": {
- "level": "partially_insulated",
- "u_value": 0.35
}, - "windows_insulation": {
- "level": "middle_class",
- "u_value": 1.8
}, - "high_floor_insulation": {
- "level": "partially_insulated",
- "u_value": 0.25
}, - "low_floor_insulation": {
- "level": "partially_insulated",
- "u_value": 0.4
}, - "vents_type": "sf_self_regulating_vmc",
- "garage": false,
- "high_floor_kinds": [
- "not_heated_space"
], - "low_floor_kinds": [
- "crawl_space"
], - "secondary_generator_energy": "gas",
- "secondary_generator_type": "condensing_gas_boiler",
- "collective_heating": false,
- "collective_hot_water": false,
- "high_floor_surface": 60,
- "low_floor_surface": 60,
- "windows_surface": 10,
- "sources": {
- "living_area": "ai",
- "exterior_walls_surface": "ai",
- "house_number_of_levels": "ai",
- "wall_material": "ai",
- "construction_year": "ai",
- "number_of_windows": "ai",
- "windows_insulation": "ai",
- "windows_surface": "ai",
- "vents_type": "ai",
- "generator_type": "ai",
- "generator_energy": "ai",
- "secondary_generator_type": "ai",
- "secondary_generator_energy": "ai",
- "hot_water_type": "ai",
- "hot_water_energy": "ai",
- "high_floor_kinds": "ai",
- "low_floor_kinds": "ai",
- "walls_insulation": "ai",
- "high_floor_insulation": "ai",
- "low_floor_insulation": "ai",
- "close_to_historical_monument": "ai",
- "shared_walls": "ai"
}
}
}Endpoint pour mettre à jour les informations de l'état initial
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
| housing_type | string Enum: "house" "apartment" Type de logement. |
| close_to_historical_monument | boolean Proximité d'un monument historique. |
| floor_level | string Enum: "ground" "intermediate" "last" Niveau de l'étage (rez-de-chaussée, intermédiaire, dernier étage). |
| living_area | number La surface habitable en mètres carrés. |
| number_of_exterior_wall | integer Nombre de murs extérieurs. |
| house_number_of_levels | integer Le nombre de niveaux dans la maison. |
| shared_walls | boolean Présence de murs mitoyens. |
object L'année de construction du bâtiment. | |
| wall_material | string Enum: "lightweight_concrete" "insulating_concrete" "stone" "brick" "hollow_or_perforated_bricks" "wood" "wood_with_insulating_infill" "rammed_or_cob_earth" "traditional_old_material" "others" Le matériau principal des murs. |
| high_floor_kinds | Array of strings Items Enum: "apartment" "converted_attic" "lost_attic" "not_heated_space" "office" "roof_terrace" "unknown" Les types de plancher haut. |
| low_floor_kinds | Array of strings Items Enum: "apartment" "crawl_space" "not_heated_space" "office" "slab_on_grade" "underground_garage" "unknown" Les types de plancher bas. |
| windows | string Enum: "high_class" "middle_class" "low_class" Le type de fenêtre. |
| number_of_windows | integer Le nombre total de fenêtres. |
| generator_energy | string Enum: "electricity" "fuel" "gas" "biomass_wood" "district_heating" "others" Le type d'énergie utilisé par le générateur de chauffage. |
| generator_type | string Enum: "air_to_air_heat_pump" "air_to_water_heat_pump" "classic_gas_boiler" "closed_fireplace_insert" "coal_boiler" "condensing_gas_boiler" "electric_boiler_or_underfloor_heating" "electric_convector_heater" "electric_radiator" "fossil_fueled_district_heating_network" "fuel_boiler" "fuel_stove" "geothermal_heat_pump" "hybrid_heat_pump" "insulated_district_heating_network" "lpg_propane_butane_boiler_with_external_tank" "low_temperature_gas_boiler" "misc_system" "other_gas_generators" "pellet_boiler" "pellet_stove" "radiant_panel_heater" "standard_gas_boiler" "uninsulated_district_heating_network" "wood_boiler" "wood_stove" Le type de générateur de chauffage. |
| secondary_generator_energy | string Enum: "electricity" "fuel" "gas" "biomass_wood" "district_heating" "others" Le type d'énergie utilisé par le chauffage secondaire. |
| secondary_generator_type | string Enum: "air_to_air_heat_pump" "air_to_water_heat_pump" "classic_gas_boiler" "closed_fireplace_insert" "coal_boiler" "condensing_gas_boiler" "electric_boiler_or_underfloor_heating" "electric_convector_heater" "electric_radiator" "fossil_fueled_district_heating_network" "fuel_boiler" "fuel_stove" "geothermal_heat_pump" "hybrid_heat_pump" "insulated_district_heating_network" "lpg_propane_butane_boiler_with_external_tank" "low_temperature_gas_boiler" "misc_system" "other_gas_generators" "pellet_boiler" "pellet_stove" "radiant_panel_heater" "standard_gas_boiler" "uninsulated_district_heating_network" "wood_boiler" "wood_stove" Le type de générateur de chauffage secondaire. |
| hot_water_energy | string Enum: "electricity" "fuel" "gas" "biomass_wood" "district_heating" "others" Le type d'énergie utilisé pour l'eau chaude sanitaire. |
| hot_water_type | string Enum: "air_to_water_heat_pump" "classic_gas_boiler" "coal_boiler" "condensing_gas_boiler" "electric_boiler" "electric_hot_water_tank" "electric_water_heater" "fossil_fueled_district_heating_network" "fuel_boiler" "gas_water_tank" "geothermal_heat_pump" "hybrid_heat_pump" "insulated_district_heating_network" "instant_gas_water_heater" "instant_lpg_propane_butane_water_heater" "lpg_propane_butane_boiler_external_tank" "lpg_propane_butane_storage_hot_water_tank" "low_temperature_gas_boiler" "other_gas_generators" "pellet_boiler" "standard_gas_boiler" "thermodynamic_water_tank" "uninsulated_district_heating_network" "wood_boiler" Le type de système de production d'eau chaude sanitaire. |
| vents_type | string Enum: "window_opening_ventilation" "high_low_air_inlet_ventilation" "natural_ventilation_duct" "mechanical_ventilation_existing_duct" "sf_self_regulating_vmc" "sf_hygro_a_vmc" "sf_hygro_b_vmc" "sf_gas_vmc" "low_pressure_vmc" "hybrid_ventilation" "individual_df_vmc" "collective_df_vmc" "climatic_well" Le type de ventilation. |
| garage | boolean Présence d'un garage. |
| collective_heating | boolean Chauffage collectif. |
| collective_hot_water | boolean Eau chaude sanitaire collective. |
| walls_insulation_level | string Enum: "no_insulation" "partially_insulated" "moderately_insulated" "well_insulated" Le niveau d'isolation des murs. |
| high_floor_insulation_level | string Enum: "no_insulation" "partially_insulated" "moderately_insulated" "well_insulated" Le niveau d'isolation du plancher haut. |
| low_floor_insulation_level | string Enum: "no_insulation" "partially_insulated" "moderately_insulated" "well_insulated" Le niveau d'isolation du plancher bas. |
| high_floor_surface | integer La surface du plancher haut en mètres carrés. |
| low_floor_surface | integer La surface du plancher bas en mètres carrés. |
| exterior_walls_surface | integer La surface extérieure des murs en mètres carrés. |
| windows_surface | integer La surface totale des fenêtres en mètres carrés. |
{- "housing_type": "apartment",
- "close_to_historical_monument": true,
- "floor_level": "ground",
- "living_area": 120,
- "number_of_exterior_wall": 3,
- "house_number_of_levels": 1,
- "shared_walls": true,
- "construction_year": {
- "range": "exact_date",
- "exact_date": 1985
}, - "wall_material": "brick",
- "high_floor_kinds": [
- "not_heated_space"
], - "low_floor_kinds": [
- "crawl_space"
], - "windows": "middle_class",
- "number_of_windows": 8,
- "generator_energy": "gas",
- "generator_type": "condensing_gas_boiler",
- "secondary_generator_energy": "gas",
- "secondary_generator_type": "condensing_gas_boiler",
- "hot_water_energy": "electricity",
- "hot_water_type": "electric_hot_water_tank",
- "vents_type": "sf_self_regulating_vmc",
- "garage": false,
- "collective_heating": false,
- "collective_hot_water": false,
- "walls_insulation_level": "partially_insulated",
- "high_floor_insulation_level": "partially_insulated",
- "low_floor_insulation_level": "partially_insulated",
- "high_floor_surface": 60,
- "low_floor_surface": 60,
- "exterior_walls_surface": 85,
- "windows_surface": 10
}{- "error": "Generator type n'est pas valide"
}Crée un plan de rénovation basé sur une sélection spécifique de gestes. L'opération est asynchrone : l'API retourne immédiatement une réponse confirmant la création, mais le plan complet n'est pas disponible dans l'instant. Pour consulter le plan généré une fois le traitement terminé, utilisez le endpoint 'Récupérer le plan de rénovation personnalisé'.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
| name | string Le nom du plan de rénovation personnalisé. |
required | object |
{- "name": "Mon plan personnalisé",
- "renovation_plan": {
- "ventilation": [
- {
- "technical_id": "dual_flow_ventilation",
- "quantity": 0,
- "price_per_unit": 0
}
], - "walls": [
- {
- "technical_id": "exterior_thermal_correction",
- "quantity": 0,
- "price_per_unit": 0,
- "error_margin": 15
}
], - "doors_windows": [
- {
- "technical_id": "windows_triple_glazed",
- "quantity": 0,
- "price_per_unit": 0
}
], - "low_floor": [
- {
- "technical_id": "crawl_space",
- "quantity": 0,
- "price_per_unit": 0,
- "error_margin": 15
}
], - "high_floor": [
- {
- "technical_id": "sloped_walls_nonreg",
- "quantity": 0,
- "price_per_unit": 0,
- "error_margin": 15
}
], - "heating": [
- {
- "technical_id": "wood_pellets_stove",
- "quantity": 0,
- "price_per_unit": 0
}
], - "hot_water": [
- {
- "technical_id": "solar_water_heater",
- "quantity": 0,
- "price_per_unit": 0
}
], - "renewable_energy": [
- {
- "technical_id": "hydroelectric_turbine",
- "quantity": 0,
- "price_per_unit": 0
}
], - "summer_comfort": [
- {
- "technical_id": "sunshade",
- "quantity": 0,
- "price_per_unit": 0
}
], - "winter_comfort": [
- {
- "technical_id": "thermal_curtains",
- "quantity": 0,
- "price_per_unit": 0
}
], - "thermal_bridge_treatment": [
- {
- "technical_id": "thermal_bridge_treatment_after_interior_insulation",
- "quantity": 0,
- "price_per_unit": 0
}
], - "lighting": [
- {
- "technical_id": "led_low_consumption_bulbs",
- "quantity": 0,
- "price_per_unit": 0
}
], - "sobriety": [
- {
- "technical_id": "rainwater_watering_system",
- "quantity": 0,
- "price_per_unit": 0
}
]
}
}{- "renovation_plan_id": "hjjcm1qp28"
}Les informations du plan de rénovation personnalisé.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
| renovation_plan_id required | string Example: hjjcm1qp28 L'identifiant du plan de rénovation personnalisé. |
{- "status": "completed",
- "id": "hjjcm1qp28",
- "name": "Mon plan personnalisé",
- "type": "customized",
- "energy_rating": "B",
- "energy_consumption": 201,
- "carbon_rating": "C",
- "carbon_emissions": 40,
- "yearly_energy_savings": 600,
- "yearly_energy_cost": 12000,
- "budget": 400,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}, - "kpi": {
- "property_value_increase": {
- "percentage": 5,
- "price_per_sqm": 115,
- "area_loss_sqm": 0
}
}, - "renovation_plan": {
- "ventilation": [
- {
- "technical_id": "dual_flow_ventilation",
- "name": "Installation d'une VMC double flux",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "walls": [
- {
- "technical_id": "exterior_thermal_correction",
- "name": "Réalisation d'une correction thermique par l'extérieur",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "doors_windows": [
- {
- "technical_id": "windows_triple_glazed",
- "name": "Pose de fenêtres à triple vitrage",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "low_floor": [
- {
- "technical_id": "crawl_space",
- "name": "Isolation du plancher bas sur vide sanitaire",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "high_floor": [
- {
- "technical_id": "sloped_walls_nonreg",
- "name": "Isolation non réglementaire des rampants de toiture",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "heating": [
- {
- "technical_id": "wood_pellets_stove",
- "name": "Installation d'un poêle à granulés",
- "quantity": 0,
- "energy": {
- "technical_id": "electricity",
- "name": "Électricité"
}, - "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}, - "recommended_power": 6.2,
- "recommended_water_tank_volume": 80
}
], - "hot_water": [
- {
- "technical_id": "solar_water_heater",
- "name": "Installation d'un chauffe-eau solaire individuel",
- "quantity": 0,
- "energy": {
- "technical_id": "electricity",
- "name": "Électricité"
}, - "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "renewable_energy": [
- {
- "technical_id": "hydroelectric_turbine",
- "name": "Installation d'une micro-turbine hydroélectrique",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "summer_comfort": [
- {
- "technical_id": "sunshade",
- "name": "Installation de brise-soleil",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "winter_comfort": [
- {
- "technical_id": "thermal_curtains",
- "name": "Installation de rideaux thermiques",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "thermal_bridge_treatment": [
- {
- "technical_id": "thermal_bridge_treatment_after_interior_insulation",
- "name": "Traitement d'une rupture de pont thermique suite à une isolation des murs par l'intérieur",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "lighting": [
- {
- "technical_id": "led_low_consumption_bulbs",
- "name": "Remplacement d'ampoules existantes par des lampes LED à faible consommation",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
], - "sobriety": [
- {
- "technical_id": "rainwater_watering_system",
- "name": "Installation d'un système d'arrosage utilisant l'eau de récupération",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}
}
]
}
}Endpoint pour démarrer la génération asynchrone du rapport PDF de la simulation. Le rapport peut optionnellement inclure les informations du client.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
object Les informations du client (nom, prénom, email, téléphone) |
{- "client": {
- "first_name": "Jean",
- "last_name": "Dupont",
- "email": "jean.dupont@example.com",
- "phone_number": "+33600112233"
}
}{- "error": "Unauthorized"
}Le statut de la génération du rapport PDF et l'URL de téléchargement.
| simulation_id required | string Example: hjjcm1qp28 L'identifiant de simulation renvoyé par l'appel au endpoint créer |
{- "status": "completed",
}Endpoint pour lister les simulations.
| status | string Value: "with_contact_details" Example: status=with_contact_details Filtrer les simulations avec des informations de contact:
|
| page | integer Example: page=1 |
{- "data": [
- {
- "id": "1fh9vrmd2c",
- "created_at": "2024-10-08T10:00:54Z",
- "team_id": "4732fnd4mt",
- "source": "api",
- "tracking_context": {
- "utm_source": "string",
- "utm_medium": "string",
- "utm_campaign": "string",
- "utm_content": "string",
- "utm_term": "string",
- "gad_source": "string",
- "gclid": "string",
- "fbclid": "string",
- "cuid": "string",
- "referer": "string",
- "gbraid": "string",
- "msclkid": "string",
- "krid": "string",
- "krsrc": "string",
- "ksid": "string"
}, - "client": {
- "first_name": "Jean",
- "last_name": "Dupont",
- "email": "jean.dupont@example.com",
- "phone_number": "+33600112233",
- "profile": "owner_resident",
- "primary_residence": true,
- "household_size": 4,
- "tax_residence_department": "75",
- "income_range": "modest",
- "project_maturity": "curious"
}, - "housing": {
- "kind": "apartment",
- "latitude": 48.8487743,
- "longitude": 2.328388,
- "address": "10 rue du Regard, 75006, Paris",
- "address_parts": {
- "street_number": "10",
- "address_line_1": "rue du Regard",
- "address_line_2": "Appartement 2",
- "city": "Paris",
- "postal_code": "75006",
- "country_number": 250,
- "latitude": 48.8487743,
- "longitude": 2.328388
}, - "ban_id": "75106_8092_00010",
}, - "initial_state": {
- "energy_rating": "B",
- "energy_consumption": 201,
- "carbon_rating": "C",
- "carbon_emissions": 40,
- "epc_id": "2169E0063000A",
- "confidence_score": 0.85,
- "annual_energy_cost_range": {
- "min": 500,
- "max": 1200
}, - "annual_energy_consumption": 150,
- "position_percentage_neighborhood": 0.75,
- "energy_loss_percentage": {
- "walls": 0.15,
- "openings": 0.2,
- "low_floor": 0.3,
- "high_floor": 0.35
}, - "close_to_historical_monument": false,
- "living_area": 120,
- "exterior_walls_surface": 100,
- "house_number_of_levels": 1,
- "shared_walls": true,
- "wall_material": "brick",
- "construction_year": 1985,
- "number_of_windows": 8,
- "generator_type": "condensing_gas_boiler",
- "generator_energy": "gas",
- "hot_water_type": "electric_hot_water_tank",
- "hot_water_energy": "electricity",
- "walls_insulation": {
- "level": "partially_insulated",
- "u_value": 0.35
}, - "windows_insulation": {
- "level": "middle_class",
- "u_value": 1.8
}, - "high_floor_insulation": {
- "level": "partially_insulated",
- "u_value": 0.25
}, - "low_floor_insulation": {
- "level": "partially_insulated",
- "u_value": 0.4
}, - "vents_type": "sf_self_regulating_vmc",
- "garage": false,
- "high_floor_kinds": [
- "not_heated_space"
], - "low_floor_kinds": [
- "crawl_space"
], - "secondary_generator_energy": "gas",
- "secondary_generator_type": "condensing_gas_boiler",
- "collective_heating": false,
- "collective_hot_water": false,
- "high_floor_surface": 60,
- "low_floor_surface": 60,
- "windows_surface": 10,
- "sources": {
- "living_area": "ai",
- "exterior_walls_surface": "ai",
- "house_number_of_levels": "ai",
- "wall_material": "ai",
- "construction_year": "ai",
- "number_of_windows": "ai",
- "windows_insulation": "ai",
- "windows_surface": "ai",
- "vents_type": "ai",
- "generator_type": "ai",
- "generator_energy": "ai",
- "secondary_generator_type": "ai",
- "secondary_generator_energy": "ai",
- "hot_water_type": "ai",
- "hot_water_energy": "ai",
- "high_floor_kinds": "ai",
- "low_floor_kinds": "ai",
- "walls_insulation": "ai",
- "high_floor_insulation": "ai",
- "low_floor_insulation": "ai",
- "close_to_historical_monument": "ai",
- "shared_walls": "ai"
}
}, - "projected_state": {
- "renovation_plans": [
- {
- "id": "hjjcm1qp28",
- "name": "Mon plan personnalisé",
- "type": "customized",
- "energy_rating": "B",
- "energy_consumption": 201,
- "carbon_rating": "C",
- "carbon_emissions": 40,
- "yearly_energy_savings": 600,
- "yearly_energy_cost": 12000,
- "budget": 12000,
- "financial_support": {
- "mpr": 0.1,
- "cee": 0.1,
- "ecoptz": 0.1,
- "local": [
- {
- "name": "Aide région Île-de-France",
- "amount": 1500
}, - {
- "name": "Aide département Seine-Saint-Denis",
- "amount": 800
}, - {
- "name": "Aide ville de Saint-Denis",
- "amount": 500
}
]
}, - "kpi": {
- "property_value_increase": {
- "percentage": 5,
- "price_per_sqm": 115,
- "area_loss_sqm": 0
}
}, - "renovation_plan": {
- "ventilation": [
- {
- "technical_id": "dual_flow_ventilation",
- "name": "Installation d'une VMC double flux",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "walls": [
- {
- "technical_id": "exterior_thermal_correction",
- "name": "Réalisation d'une correction thermique par l'extérieur",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "doors_windows": [
- {
- "technical_id": "windows_triple_glazed",
- "name": "Pose de fenêtres à triple vitrage",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "low_floor": [
- {
- "technical_id": "crawl_space",
- "name": "Isolation du plancher bas sur vide sanitaire",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "high_floor": [
- {
- "technical_id": "sloped_walls_nonreg",
- "name": "Isolation non réglementaire des rampants de toiture",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "heating": [
- {
- "technical_id": "wood_pellets_stove",
- "name": "Installation d'un poêle à granulés",
- "quantity": 0,
- "energy": {
- "technical_id": null,
- "name": null
}, - "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}, - "recommended_power": 6.2,
- "recommended_water_tank_volume": 80
}
], - "hot_water": [
- {
- "technical_id": "solar_water_heater",
- "name": "Installation d'un chauffe-eau solaire individuel",
- "quantity": 0,
- "energy": {
- "technical_id": null,
- "name": null
}, - "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "renewable_energy": [
- {
- "technical_id": "hydroelectric_turbine",
- "name": "Installation d'une micro-turbine hydroélectrique",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "summer_comfort": [
- {
- "technical_id": "sunshade",
- "name": "Installation de brise-soleil",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "winter_comfort": [
- {
- "technical_id": "thermal_curtains",
- "name": "Installation de rideaux thermiques",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "thermal_bridge_treatment": [
- {
- "technical_id": "thermal_bridge_treatment_after_interior_insulation",
- "name": "Traitement d'une rupture de pont thermique suite à une isolation des murs par l'intérieur",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "lighting": [
- {
- "technical_id": "led_low_consumption_bulbs",
- "name": "Remplacement d'ampoules existantes par des lampes LED à faible consommation",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
], - "sobriety": [
- {
- "technical_id": "rainwater_watering_system",
- "name": "Installation d'un système d'arrosage utilisant l'eau de récupération",
- "quantity": 0,
- "budget": 0.1,
- "financial_support": {
- "mpr": null,
- "cee": null,
- "ecoptz": null,
- "local": [ ]
}
}
]
}
}
]
}
}
], - "meta": {
- "total_pages": 0,
- "current_page": 0,
- "total_count": 0
}
}