Compliance & Regulation

Energy Diagnosis API

Manage DPE certificates (Diagnostic de Performance Energetique) — the mandatory energy performance assessments required for all French rental properties. Track energy ratings, validity, and compliance.

Quick Example

Code
 
curl -X POST https://api.faireplace.com/api/places/<place_uuid>/energy-diagnoses \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "diagnosis_type": "DPE",
    "energy_rating": "C",
    "climate_rating": "B",
    "energy_consumption_kwh": 145,
    "co2_emissions_kg": 32,
    "diagnosis_date": "2026-01-15T00:00:00Z",
    "diagnostician_name": "Cabinet Expertise Energie",
    "diagnostician_license": "DPE-2024-75001",
    "property_surface": 45.0,
    "heating_system": "GasBoiler"
  }'

Common Workflows

Ensure compliance before leasing

GET /api/places/{id}/compliance/energy — Check if a valid DPE exists
POST /api/places/{id}/energy-diagnoses — Upload DPE if missing
The DPE rating will appear on the lease document

Monitor DPE expiration across portfolio

GET /api/places/{id}/energy-diagnoses — List all diagnoses
GET /api/places/{id}/energy-diagnoses/{id}/validity — Check days remaining
Schedule renewal before expiration (DPE valid for 10 years)

Overview

Energy diagnosis management includes:

DPE Certificates: Official energy performance certificates
Energy Ratings: A-G energy efficiency classifications
Compliance Tracking: Mandatory diagnosis requirements
Validity Management: Certificate expiration and renewal
Building vs Unit: Assessments at different property levels

Authentication

Requires PropertiesRead, PropertiesWrite, or PropertiesDelete permissions.

Base URL

Energy diagnosis endpoints are nested under properties:

Places: /api/places/{place_id}/energy-diagnoses
Estates: /api/places/{place_id}/estates/{estate_id}/energy-diagnoses

Core Operations

List Energy Diagnoses

GET /api/places/{place_id}/energy-diagnoses

Response:


Code
 
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "place_id": "550e8400-e29b-41d4-a716-446655440001",
    "estate_id": null,
    "diagnosis_type": "DPE",
    "energy_rating": "C",
    "climate_rating": "B",
    "energy_consumption_kwh": 150,
    "co2_emissions_kg": 35,
    "diagnosis_date": "2023-06-15T00:00:00Z",
    "validity_date": "2033-06-15T00:00:00Z",
    "diagnostician_name": "Jean Diagnostic",
    "diagnostician_license": "DPE123456",
    "certificate_number": "2306150001",
    "property_surface": 75.5,
    "heating_system": "GasBoiler",
    "is_valid": true,
    "created_at": "2023-06-15T10:30:00Z"
  }
]

Create Energy Diagnosis

POST /api/places/{place_id}/energy-diagnoses

Request:


Code
 
{
  "diagnosis_type": "DPE",
  "energy_rating": "B",
  "climate_rating": "A",
  "energy_consumption_kwh": 120,
  "co2_emissions_kg": 25,
  "diagnosis_date": "2024-01-15T00:00:00Z",
  "diagnostician_name": "Marie Expertise",
  "diagnostician_license": "DPE789012",
  "certificate_number": "2401150001",
  "property_surface": 80.0,
  "heating_system": "HeatPump",
  "recommendations": [
    "Improve window insulation",
    "Upgrade heating system controls"
  ]
}

Get Energy Diagnosis

GET /api/places/{place_id}/energy-diagnoses/{diagnosis_id}

Update Energy Diagnosis

PUT /api/places/{place_id}/energy-diagnoses/{diagnosis_id}

Delete Energy Diagnosis

DELETE /api/places/{place_id}/energy-diagnoses/{diagnosis_id}

Estate-Level Diagnoses

List Estate Energy Diagnoses

GET /api/places/{place_id}/estates/{estate_id}/energy-diagnoses

Create Estate Energy Diagnosis

POST /api/places/{place_id}/estates/{estate_id}/energy-diagnoses

Similar to place-level operations but specific to individual units.

Energy Ratings

Energy Efficiency Scale

A: ≤ 50 kWh/m²/year (Very efficient)
B: 51-90 kWh/m²/year (Efficient)
C: 91-150 kWh/m²/year (Good)
D: 151-230 kWh/m²/year (Average)
E: 231-330 kWh/m²/year (Poor)
F: 331-420 kWh/m²/year (Very poor)
G: > 420 kWh/m²/year (Extremely poor)

Climate Impact Scale

A: ≤ 5 kg CO₂/m²/year (Very low impact)
B: 6-10 kg CO₂/m²/year (Low impact)
C: 11-20 kg CO₂/m²/year (Moderate impact)
D: 21-35 kg CO₂/m²/year (Average impact)
E: 36-55 kg CO₂/m²/year (High impact)
F: 56-80 kg CO₂/m²/year (Very high impact)
G: > 80 kg CO₂/m²/year (Extremely high impact)

Heating Systems

Common heating systems tracked:

GasBoiler - Natural gas boiler
ElectricHeating - Electric heating
HeatPump - Air or ground source heat pump
OilBoiler - Oil-fired boiler
DistrictHeating - Centralized heating network
WoodPellet - Biomass/wood pellet system
Solar - Solar heating system

Diagnosis Types

DPE (Diagnostic de Performance Énergétique)

Mandatory for sales and rentals
Valid for 10 years
A-G energy and climate ratings

Audit Énergétique

Detailed energy audit
Required for certain property sales
Comprehensive improvement recommendations

Validation and Compliance

Check Validity

GET /api/places/{place_id}/energy-diagnoses/{id}/validity

Response:


Code
 
{
  "is_valid": true,
  "validity_date": "2033-06-15T00:00:00Z",
  "days_remaining": 3287,
  "renewal_required": false,
  "compliance_status": "Compliant"
}

Compliance Check

GET /api/places/{place_id}/compliance/energy

Response:


Code
 
{
  "is_compliant": true,
  "missing_diagnoses": [],
  "expired_diagnoses": [],
  "upcoming_renewals": [
    {
      "diagnosis_id": "550e8400-e29b-41d4-a716-446655440000",
      "expires_in_days": 180
    }
  ]
}

Error Responses

400 Bad Request


Code
 
{
  "error": "ValidationError",
  "message": "Invalid energy rating",
  "details": {
    "valid_ratings": ["A", "B", "C", "D", "E", "F", "G"]
  }
}

422 Unprocessable Entity


Code
 
{
  "error": "ComplianceError",
  "message": "Diagnosis date cannot be in the future"
}

Common Use Cases

Property Marketing

Display energy ratings in property listings
Highlight energy-efficient properties
Provide energy cost estimates to tenants

Compliance Management

Track diagnosis validity dates
Schedule renewal reminders
Ensure all properties have valid diagnoses

Energy Performance Tracking

Monitor building energy efficiency
Track improvements after renovations
Compare performance across portfolio

Legal Requirements

Provide mandatory diagnosis for lease agreements
Include energy ratings in property advertisements
Archive diagnosis certificates for legal compliance

French Legal Requirements

Mandatory Diagnoses

All Rentals: DPE required for all rental properties
Sales: DPE mandatory for property sales
Validity: 10-year validity period for DPE
Display: Energy rating must be shown in advertisements

Penalties

Missing or invalid DPE can result in fines
Incorrect information can invalidate lease agreements
Professional liability for diagnosticians

Recent Changes

New DPE methodology since July 2021
Stricter energy consumption calculations
Enhanced reliability and accuracy requirements

Integration Notes

Property Listings: Energy ratings displayed in marketing materials
Lease Compliance: Automatic validation of diagnosis requirements
Renewal Tracking: Automated reminders for expiring diagnoses
Document Storage: Integration with media API for certificate storage
Reporting: Energy performance analytics and portfolio reporting

Last modified on February 21, 2026

Rent Regulation Errors & Troubleshooting

Compliance & Regulation

Energy Diagnosis API

Quick Example

Code
 
curl -X POST https://api.faireplace.com/api/places/<place_uuid>/energy-diagnoses \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "diagnosis_type": "DPE",
    "energy_rating": "C",
    "climate_rating": "B",
    "energy_consumption_kwh": 145,
    "co2_emissions_kg": 32,
    "diagnosis_date": "2026-01-15T00:00:00Z",
    "diagnostician_name": "Cabinet Expertise Energie",
    "diagnostician_license": "DPE-2024-75001",
    "property_surface": 45.0,
    "heating_system": "GasBoiler"
  }'

Common Workflows

Ensure compliance before leasing

GET /api/places/{id}/compliance/energy — Check if a valid DPE exists
POST /api/places/{id}/energy-diagnoses — Upload DPE if missing
The DPE rating will appear on the lease document

Monitor DPE expiration across portfolio

GET /api/places/{id}/energy-diagnoses — List all diagnoses
GET /api/places/{id}/energy-diagnoses/{id}/validity — Check days remaining
Schedule renewal before expiration (DPE valid for 10 years)

Overview

Energy diagnosis management includes:

DPE Certificates: Official energy performance certificates
Energy Ratings: A-G energy efficiency classifications
Compliance Tracking: Mandatory diagnosis requirements
Validity Management: Certificate expiration and renewal
Building vs Unit: Assessments at different property levels

Authentication

Requires PropertiesRead, PropertiesWrite, or PropertiesDelete permissions.

Base URL

Energy diagnosis endpoints are nested under properties:

Places: /api/places/{place_id}/energy-diagnoses
Estates: /api/places/{place_id}/estates/{estate_id}/energy-diagnoses

Core Operations

List Energy Diagnoses

GET /api/places/{place_id}/energy-diagnoses

Response:


Code
 
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "place_id": "550e8400-e29b-41d4-a716-446655440001",
    "estate_id": null,
    "diagnosis_type": "DPE",
    "energy_rating": "C",
    "climate_rating": "B",
    "energy_consumption_kwh": 150,
    "co2_emissions_kg": 35,
    "diagnosis_date": "2023-06-15T00:00:00Z",
    "validity_date": "2033-06-15T00:00:00Z",
    "diagnostician_name": "Jean Diagnostic",
    "diagnostician_license": "DPE123456",
    "certificate_number": "2306150001",
    "property_surface": 75.5,
    "heating_system": "GasBoiler",
    "is_valid": true,
    "created_at": "2023-06-15T10:30:00Z"
  }
]

Create Energy Diagnosis

POST /api/places/{place_id}/energy-diagnoses

Request:


Code
 
{
  "diagnosis_type": "DPE",
  "energy_rating": "B",
  "climate_rating": "A",
  "energy_consumption_kwh": 120,
  "co2_emissions_kg": 25,
  "diagnosis_date": "2024-01-15T00:00:00Z",
  "diagnostician_name": "Marie Expertise",
  "diagnostician_license": "DPE789012",
  "certificate_number": "2401150001",
  "property_surface": 80.0,
  "heating_system": "HeatPump",
  "recommendations": [
    "Improve window insulation",
    "Upgrade heating system controls"
  ]
}

Get Energy Diagnosis

GET /api/places/{place_id}/energy-diagnoses/{diagnosis_id}

Update Energy Diagnosis

PUT /api/places/{place_id}/energy-diagnoses/{diagnosis_id}

Delete Energy Diagnosis

DELETE /api/places/{place_id}/energy-diagnoses/{diagnosis_id}

Estate-Level Diagnoses

List Estate Energy Diagnoses

GET /api/places/{place_id}/estates/{estate_id}/energy-diagnoses

Create Estate Energy Diagnosis

POST /api/places/{place_id}/estates/{estate_id}/energy-diagnoses

Similar to place-level operations but specific to individual units.

Energy Ratings

Energy Efficiency Scale

A: ≤ 50 kWh/m²/year (Very efficient)
B: 51-90 kWh/m²/year (Efficient)
C: 91-150 kWh/m²/year (Good)
D: 151-230 kWh/m²/year (Average)
E: 231-330 kWh/m²/year (Poor)
F: 331-420 kWh/m²/year (Very poor)
G: > 420 kWh/m²/year (Extremely poor)

Climate Impact Scale

A: ≤ 5 kg CO₂/m²/year (Very low impact)
B: 6-10 kg CO₂/m²/year (Low impact)
C: 11-20 kg CO₂/m²/year (Moderate impact)
D: 21-35 kg CO₂/m²/year (Average impact)
E: 36-55 kg CO₂/m²/year (High impact)
F: 56-80 kg CO₂/m²/year (Very high impact)
G: > 80 kg CO₂/m²/year (Extremely high impact)

Heating Systems

Common heating systems tracked:

GasBoiler - Natural gas boiler
ElectricHeating - Electric heating
HeatPump - Air or ground source heat pump
OilBoiler - Oil-fired boiler
DistrictHeating - Centralized heating network
WoodPellet - Biomass/wood pellet system
Solar - Solar heating system

Diagnosis Types

DPE (Diagnostic de Performance Énergétique)

Mandatory for sales and rentals
Valid for 10 years
A-G energy and climate ratings

Audit Énergétique

Detailed energy audit
Required for certain property sales
Comprehensive improvement recommendations

Validation and Compliance

Check Validity

GET /api/places/{place_id}/energy-diagnoses/{id}/validity

Response:


Code
 
{
  "is_valid": true,
  "validity_date": "2033-06-15T00:00:00Z",
  "days_remaining": 3287,
  "renewal_required": false,
  "compliance_status": "Compliant"
}

Compliance Check

GET /api/places/{place_id}/compliance/energy

Response:


Code
 
{
  "is_compliant": true,
  "missing_diagnoses": [],
  "expired_diagnoses": [],
  "upcoming_renewals": [
    {
      "diagnosis_id": "550e8400-e29b-41d4-a716-446655440000",
      "expires_in_days": 180
    }
  ]
}

Error Responses

400 Bad Request


Code
 
{
  "error": "ValidationError",
  "message": "Invalid energy rating",
  "details": {
    "valid_ratings": ["A", "B", "C", "D", "E", "F", "G"]
  }
}

422 Unprocessable Entity


Code
 
{
  "error": "ComplianceError",
  "message": "Diagnosis date cannot be in the future"
}

Common Use Cases

Property Marketing

Display energy ratings in property listings
Highlight energy-efficient properties
Provide energy cost estimates to tenants

Compliance Management

Track diagnosis validity dates
Schedule renewal reminders
Ensure all properties have valid diagnoses

Energy Performance Tracking

Monitor building energy efficiency
Track improvements after renovations
Compare performance across portfolio

Legal Requirements

Provide mandatory diagnosis for lease agreements
Include energy ratings in property advertisements
Archive diagnosis certificates for legal compliance

French Legal Requirements

Mandatory Diagnoses

All Rentals: DPE required for all rental properties
Sales: DPE mandatory for property sales
Validity: 10-year validity period for DPE
Display: Energy rating must be shown in advertisements

Penalties

Missing or invalid DPE can result in fines
Incorrect information can invalidate lease agreements
Professional liability for diagnosticians

Recent Changes

New DPE methodology since July 2021
Stricter energy consumption calculations
Enhanced reliability and accuracy requirements

Integration Notes

Property Listings: Energy ratings displayed in marketing materials
Lease Compliance: Automatic validation of diagnosis requirements
Renewal Tracking: Automated reminders for expiring diagnoses
Document Storage: Integration with media API for certificate storage
Reporting: Energy performance analytics and portfolio reporting

Last modified on February 21, 2026

Rent Regulation Errors & Troubleshooting