Partner API

API Documentation

The Enausweis API provides programmatic access to your energy certificates. All API access is over HTTPS, and all data is sent and received as JSON.

Authentication

All API requests require authentication using a Bearer token. Include your access token in the Authorization header of every request.

Your access token is provided when your partner account is created. If you need to regenerate your token, please contact us.

Request Header
Authorization: Bearer YOUR_ACCESS_TOKEN
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  https://www.enausweis.de/api/v1/identity

Data Formats

All data is sent and received as JSON. Please note the following format requirements:

  • Decimal numbers (floats): Use American notation with a period as decimal separator. For example, use 10.5 instead of 10,5.

Error Responses

The API uses conventional HTTP response codes to indicate the success or failure of a request. For validation errors (422), the response includes an errors object with detailed information about what failed.

Status Code Description
200 OK - Request succeeded
201 Created - Resource created successfully
400 Bad Request - Invalid or missing parameters
401 Unauthorized - Invalid or missing authentication token
404 Not Found - The requested resource does not exist
422 Unprocessable Entity - Validation failed
429 Too Many Requests - More than 120 requests per minute for this partner. Wait for the seconds given in the Retry-After header
Error Response Example (404 Not Found)
{}

Pagination

List endpoints return paginated results. You can control pagination using query parameters, and pagination metadata is included in response headers.

Query Parameters

Parameter Description
page Page number (default: 1)
items Number of items per page

Response Headers

Pagination metadata is included in the response headers:

Header Description
Current-Page Current page number
Page-Items Number of items on current page
Total-Pages Total number of pages
Total-Count Total number of items
Example Request with Pagination
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://www.enausweis.de/api/v1/certifications?page=2&items=10"

Endpoints

All endpoints are relative to the base URL: https://www.enausweis.de/api/v1

Identity

Retrieve and update information about your partner account.

GET /identity

Returns the authenticated partner's account information.

Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/identity
Response
{
  "company_name": "Example GmbH",
  "contact_email": "kontakt@example.de",
  "contact_first_name": "Max",
  "contact_last_name": "Mustermann",
  "phone": "+49 30 12345678",
  "website": "https://example.de",
  "status": "active",
  "dibt_self_service": false,
  "dibt_username": null,
  "dibt_password": null,
  "issuer_first_name": null,
  "issuer_last_name": null,
  "issuer_company_name": null,
  "issuer_designation": null,
  "issuer_street": null,
  "issuer_postal_code": null,
  "issuer_city": null,
  "created_at": "2024-12-01T09:00:00Z"
}
PATCH /identity

Updates the authenticated partner's account information.

Request Body Parameters

Parameter Type Required
company_namestringNo
contact_first_namestringNo
contact_last_namestringNo
contact_emailstringNo
phonestringNo
websitestringNo
dibt_self_servicebooleanNo
dibt_usernamestringNo
dibt_passwordstringNo
issuer_first_namestringNo
issuer_last_namestringNo
issuer_company_namestringNo
issuer_designationstringNo
issuer_streetstringNo
issuer_postal_codestringNo
issuer_citystringNo
Example Request
curl -X PATCH https://www.enausweis.de/api/v1/identity \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "identity": {
      "company_name": "ACME Immobilien Nord GmbH",
      "contact_first_name": "Anna",
      "contact_last_name": "Schmidt",
      "contact_email": "partner@acme-immobilien.de",
      "phone": "+49 30 98765432",
      "website": "https://acme-immobilien.de"
    }
  }'
Response
{
  "id": 3,
  "company_name": "ACME Immobilien Nord GmbH",
  "contact_email": "partner@acme-immobilien.de",
  "contact_first_name": "Anna",
  "contact_last_name": "Schmidt",
  "phone": "+49 30 98765432",
  "website": "https://acme-immobilien.de",
  "status": "active",
  "dibt_self_service": true,
  "dibt_username": "acme@dibt-test.de",
  "dibt_password": "******1234",
  "issuer_first_name": "Anna",
  "issuer_last_name": "Schmidt",
  "issuer_company_name": "ACME Aussteller GmbH",
  "issuer_designation": "Energieeffizienz-Experte",
  "issuer_street": "Musterstrasse 1",
  "issuer_postal_code": "10115",
  "issuer_city": "Berlin",
  "created_at": "2025-01-28T14:30:00Z"
}

Certifications

Access energy certificates associated with your partner account.

GET /certifications

Returns a paginated list of all certifications for your partner account.

Query Parameters

Parameter Description
type Filter by certificate type. Allowed values: Verbrauchsausweis, Bedarfsausweis (case-insensitive)
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/certifications
Example Request with Type Filter
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://www.enausweis.de/api/v1/certifications?type=Verbrauchsausweis"
Response (Verbrauchsausweis)
[
  {
    "id": 1,
    "type": "Verbrauchsausweis",
    "reference_number": "EA-2025-00001",
    "partner_reference_number": "OBJ-4711",
    "reason": "sale",
    "status": "issued",
    "mode": "live",
    "street": "Musterstrasse",
    "street_number": "123",
    "postal_code": "10115",
    "city": "Berlin",
    "created_at": "2025-01-15T09:00:00Z",
    "energy_improvements_possible": true,
    "additional_notes": "Ergänzende Erläuterungen zum Energieausweis.",
    "api_url": "https://www.enausweis.de/api/v1/certifications/1",
    "building": {
      "building_type": "einfamilienhaus",
      "year_of_construction": 1985,
      "living_area": 150.0,
      "construction_method": "massivbauweise",
      "number_of_residential_units": 1,
      "commercial_usage": "residential",
      "has_thermal_glazing": true,
      "has_roof_insulation": false,
      "has_upper_completion_insulation": false,
      "has_wall_insulation": true,
      "has_basement_insulation": false
    },
    "system": {
      "heating_1_generator": "brennwertkessel",
      "heating_1_energy_carrier": "erdgas",
      "heating_1_energy_carrier_unit": "kwh",
      "heating_1_year_of_construction": 2010,
      "has_heating_2": false,
      "has_heating_3": false,
      "hot_water_included_in_heating": true,
      "ventilation_type": "fensterlueftung",
      "has_heated_basement": false,
      "has_cooling": false,
      "has_pv": false,
      "has_solar": false
    },
    "consumption": {
      "year_1_started_at": "2022-01-01",
      "year_2_started_at": "2023-01-01",
      "year_3_started_at": "2024-01-01",
      "heating_1_year_1": 15000.0,
      "heating_1_year_2": 14500.0,
      "heating_1_year_3": 14000.0,
      "hot_water_type": "heating_system",
      "has_vacancy": false
    },
    "calculation": {
      "energy": 98.3,
      "primary_energy": 105.7,
      "energy_efficiency_class": "C",
      "co2_emissions": 22.4
    },
    "documents": [
      {
        "id": 7,
        "category": "certification_image",
        "category_name": "Gebäudebild",
        "filename": "gebaeude.jpg",
        "content_type": "image/jpeg",
        "byte_size": 204800,
        "download_url": "https://www.enausweis.de/verbrauchsausweis/{{TOKEN}}/dokumente/7",
        "created_at": "2025-01-15T08:30:00Z"
      }
    ],
    "submission": {
      "submitted_at": "2025-01-15T10:00:00Z"
    },
    "issuance": {
      "issued_at": "2025-01-16T14:00:00Z",
      "pdf_url": "https://www.enausweis.de/verbrauchsausweis/TOKEN/Energieausweis-REFERENCE_NUMBER.pdf",
      "control_file_url": "https://www.enausweis.de/verbrauchsausweis/TOKEN/Kontrolldatei-REFERENCE_NUMBER.xml"
    },
    "recommendations": [
      {
        "position": 1,
        "component_type": "dach",
        "description": "Wärmedämmung der obersten Geschossdecke oder des Daches",
        "modernization_combination": "larger_modernization",
        "estimated_amortization": "8-12 Jahre",
        "estimated_cost_per_kwh": null
      }
    ]
  }
]
Response (Bedarfsausweis)
[
  {
    "id": 2,
    "type": "Bedarfsausweis",
    "reference_number": "EA-2025-00002",
    "partner_reference_number": null,
    "reason": "sale",
    "status": "issued",
    "mode": "live",
    "street": "Musterstrasse",
    "street_number": "456",
    "postal_code": "10115",
    "city": "Berlin",
    "created_at": "2025-01-15T09:00:00Z",
    "energy_improvements_possible": true,
    "additional_notes": null,
    "api_url": "https://www.enausweis.de/api/v1/certifications/2",
    "building": {
      "building_type": "einfamilienhaus",
      "year_of_construction": 1985,
      "living_area": 150.0,
      "construction_method": "massivbauweise",
      "number_of_residential_units": 1,
      "commercial_usage": "residential"
    },
    "envelope": {
      "lower_completion_type": "stahlbeton",
      "wall_type": "massiv_hlz_hbl",
      "window_type": "kunststoff_zweifach_verglast",
      "window_year_of_construction": 2005,
      "has_roller_shutter_boxes": false,
      "has_radiator_niches": false,
      "airtightness": "category_2",
      "roof_type": "satteldach",
      "roof_construction_method": "holzbauweise",
      "roof_ridge_wall": "wall_a",
      "roof_attic_heated": false,
      "roof_height": null,
      "roof_jamb_height": 0.8,
      "has_roof_window": false,
      "later_insulation": false,
      "basement_type": "unheated"
    },
    "system": {
      "heating_1_generator": "brennwertkessel",
      "heating_1_emission_type": "heizkoerper",
      "heating_1_energy_carrier": "erdgas",
      "heating_1_energy_carrier_unit": "kwh",
      "heating_1_year_of_construction": 2010,
      "heating_1_share_percentage": 100,
      "has_heating_2": false,
      "has_heating_3": false,
      "hot_water_included_in_heating": true,
      "ventilation_type": "fensterlueftung",
      "has_cooling": false,
      "has_pv": false,
      "has_solar": false
    },
    "geometry": {
      "shape": "rectangle",
      "number_of_floors": 2,
      "clear_room_height": 2.7,
      "ceiling_thickness": 0.3,
      "orientation_wall_a": "north",
      "wall_a_length": 10.0,
      "wall_b_length": 8.0,
      "wall_c_length": null,
      "wall_d_length": null,
      "wall_e_length": null,
      "wall_f_length": null,
      "has_border_walls": false,
      "border_walls": null
    },
    "calculation": {
      "energy": 142.5,
      "primary_energy": 153.0,
      "energy_efficiency_class": "D",
      "co2_emissions": 32.1
    },
    "documents": [
      {
        "id": 12,
        "category": "certification_image",
        "category_name": "Gebäudebild",
        "filename": "gebaeude.jpg",
        "content_type": "image/jpeg",
        "byte_size": 187392,
        "download_url": "https://www.enausweis.de/bedarfsausweis/{{TOKEN}}/dokumente/12",
        "created_at": "2025-01-15T08:45:00Z"
      }
    ],
    "submission": {
      "submitted_at": "2025-01-15T10:00:00Z"
    },
    "issuance": {
      "issued_at": "2025-01-16T14:00:00Z",
      "pdf_url": "https://www.enausweis.de/bedarfsausweis/TOKEN/Energieausweis-REFERENCE_NUMBER.pdf",
      "control_file_url": "https://www.enausweis.de/bedarfsausweis/TOKEN/Kontrolldatei-REFERENCE_NUMBER.xml"
    },
    "recommendations": [
      {
        "position": 1,
        "component_type": "dach",
        "description": "Wärmedämmung der obersten Geschossdecke oder des Daches",
        "modernization_combination": "larger_modernization",
        "estimated_amortization": "8-12 Jahre",
        "estimated_cost_per_kwh": null
      }
    ]
  }
]
GET /certifications/:id

Returns a single certification by ID.

Path Parameters

Parameter Description
id The certification ID
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/certifications/1
Response
{
  "id": 1,
  "type": "Verbrauchsausweis",
  "reference_number": "EA-2025-00001",
  "partner_reference_number": "OBJ-4711",
  "reason": "sale",
  "status": "issued",
  "mode": "live",
  "street": "Musterstrasse",
  "street_number": "123",
  "postal_code": "10115",
  "city": "Berlin",
  "created_at": "2025-01-15T09:00:00Z",
  "energy_improvements_possible": true,
  "additional_notes": "Ergänzende Erläuterungen zum Energieausweis.",
  "api_url": "https://www.enausweis.de/api/v1/certifications/1",
  "building": {
    "building_type": "einfamilienhaus",
    "year_of_construction": 1985,
    "living_area": 150.0,
    "construction_method": "massivbauweise",
    "number_of_residential_units": 1,
    "commercial_usage": "residential",
    "has_thermal_glazing": true,
    "has_roof_insulation": false,
    "has_upper_completion_insulation": false,
    "has_wall_insulation": true,
    "has_basement_insulation": false
  },
  "system": {
    "heating_1_generator": "brennwertkessel",
    "heating_1_energy_carrier": "erdgas",
    "heating_1_energy_carrier_unit": "kwh",
    "heating_1_year_of_construction": 2010,
    "has_heating_2": false,
    "has_heating_3": false,
    "hot_water_included_in_heating": true,
    "ventilation_type": "fensterlueftung",
    "has_heated_basement": false,
    "has_cooling": false,
    "has_pv": false,
    "has_solar": false
  },
  "consumption": {
    "year_1_started_at": "2022-01-01",
    "year_2_started_at": "2023-01-01",
    "year_3_started_at": "2024-01-01",
    "heating_1_year_1": 15000.0,
    "heating_1_year_2": 14500.0,
    "heating_1_year_3": 14000.0,
    "hot_water_type": "heating_system",
    "has_vacancy": false
  },
  "calculation": {
    "energy": 98.3,
    "primary_energy": 105.7,
    "energy_efficiency_class": "C",
    "co2_emissions": 22.4
  },
  "documents": [
    {
      "id": 7,
      "category": "certification_image",
      "category_name": "Gebäudebild",
      "filename": "gebaeude.jpg",
      "content_type": "image/jpeg",
      "byte_size": 204800,
      "download_url": "https://www.enausweis.de/verbrauchsausweis/{{TOKEN}}/dokumente/7",
      "created_at": "2025-01-15T08:30:00Z"
    }
  ],
  "submission": {
    "submitted_at": "2025-01-15T10:00:00Z"
  },
  "issuance": {
    "issued_at": "2025-01-16T14:00:00Z",
    "pdf_url": "https://www.enausweis.de/verbrauchsausweis/TOKEN/Energieausweis-REFERENCE_NUMBER.pdf",
    "control_file_url": "https://www.enausweis.de/verbrauchsausweis/TOKEN/Kontrolldatei-REFERENCE_NUMBER.xml"
  },
  "recommendations": [
    {
      "position": 1,
      "component_type": "dach",
      "description": "Wärmedämmung der obersten Geschossdecke oder des Daches",
      "modernization_combination": "larger_modernization",
      "estimated_amortization": "8-12 Jahre",
      "estimated_cost_per_kwh": null
    }
  ]
}

Note: Bedarfsausweis responses include geometry and envelope instead of consumption. Both types include a calculation object once the certificate has been calculated.

POST /certifications

Creates a new energy certificate. The certificate will be created in draft status. Depending on the certificate type, different building data is required.

Request Body Parameters

Parameter Required Description
type Yes "bedarfsausweis" or "verbrauchsausweis"
reason Yes "sale", "modernization", or "misc"
street Yes Street name of the property
street_number Yes Street number
postal_code Yes Postal code
city Yes City name
mode No "live" (default) or "test". Test certificates will not be issued with real Dibt data.
building Yes Building data object (see below)
system Yes Heating/system data object (see below)

Building Parameters (required for all types)

Parameter Type Required Example Description
building_type string true "einfamilienhaus" einfamilienhaus, zweifamilienhaus, mehrfamilienhaus, wohnteil_gemischt_genutztes_gebaeude, beidseitig_angebautes_gebaeude, einseitig_angebautes_gebaeude, sonstiges
year_of_construction integer true 1990 Year built (1500 - current year)
living_area decimal true 120.5 Living area in m²
construction_method string true "massivbauweise" massivbauweise, holztafelbau_fertighaus, fachwerk
number_of_residential_units integer true 1 Number of units (positive integer)
commercial_usage string optional "residential" residential (default), mixed_residential_like, mixed_non_residential_like, mixed_commercial_dominant

System Parameters (heating, cooling, renewables)

Parameter Type Required Example Description
heating_1_generator string true "brennwertkessel" standardkessel, niedertemperaturkessel, brennwertkessel, etc.
heating_1_emission_type string true "heizkoerper" heizkoerper, fussbodenheizung
heating_1_energy_carrier string true "erdgas" erdgas, heizoel, strom, holzpellets, etc.
heating_1_energy_carrier_unit string true "kwh" kwh, m3, liter, kg, raummeter, schuettraummeter. Available units depend on the selected energy_carrier.
heating_1_year_of_construction integer optional 2010 Year of heating system construction
has_heating_2 boolean optional false Enables second heating system fields (default: false)
heating_2_generator string if has_heating_2 "ofen_kamin" Same values as heating_1_generator
heating_2_emission_type string if has_heating_2 "heizkoerper" Same values as heating_1_emission_type
heating_2_energy_carrier string if has_heating_2 "brennholz" Same values as heating_1_energy_carrier
heating_2_energy_carrier_unit string if has_heating_2 "raummeter" Same values as heating_1_energy_carrier_unit
heating_2_share_percentage integer if has_heating_2 30 Share of second heating in percent (1-99). heating_1_share_percentage is automatically calculated as the remainder, so heating 2 and 3 together must leave at least 1.
heating_2_year_of_construction integer optional 2015 Year of second heating system construction
has_heating_3 boolean optional false Enables third heating system (default: false). Requires has_heating_2 to be true.
heating_3_generator string if has_heating_3 "infrarot_elektro" Same values as heating_1_generator
heating_3_emission_type string if has_heating_3 "heizkoerper" Same values as heating_1_emission_type
heating_3_energy_carrier string if has_heating_3 "strom" Same values as heating_1_energy_carrier
heating_3_energy_carrier_unit string if has_heating_3 "kwh" Same values as heating_1_energy_carrier_unit
heating_3_share_percentage integer if has_heating_3 20 Share of third heating in percent (1-98)
heating_3_year_of_construction integer optional 2020 Year of third heating system construction
hot_water_included_in_heating boolean optional true Whether hot water is included in heating (default: true). Must be false when every heating generator is elektro_nachtspeicher or infrarot_elektro. Bedarfsausweis only.
hot_water_generator string if hot_water_included_in_heating is false "elektro_durchlauferhitzer" Hot water generator type. Bedarfsausweis only.
hot_water_energy_carrier string if hot_water_included_in_heating is false "strom" Energy source for hot water. Bedarfsausweis only.
hot_water_energy_carrier_unit string if hot_water_included_in_heating is false "kwh" Unit for hot water energy carrier. Bedarfsausweis only.
hot_water_year_of_construction integer optional 2010 Year of hot water system construction. Bedarfsausweis only.
ventilation_type string optional "fensterlueftung" fensterlueftung (default), schachtlueftung, lueftungsanlage_ohne_waermerueckgewinnung, lueftungsanlage_mit_waermerueckgewinnung
has_heated_basement boolean optional false Whether basement is heated (default: false). Verbrauchsausweis only.
has_cooling boolean optional false Enables cooling system fields (default: false)
cooling_capacity string if has_cooling is true "less_than_12kw" less_than_12kw, greater_than_12kw_without_automation, greater_than_12kw_with_automation, greater_than_70kw
cooling_cooled_area decimal if has_cooling is true 50.0 Cooled area in m²
cooling_systems_count integer if has_cooling is true 2 Number of cooling systems
next_inspection_date date if cooling_capacity is not less_than_12kw 2030-01-15 Next inspection due date
has_pv boolean optional false Enables photovoltaic fields (default: false)
pv_orientation string if has_pv is true "south" PV panel orientation. Bedarfsausweis only.
pv_incline integer if has_pv is true 30 PV panel inclination in degrees. Bedarfsausweis only.
pv_area decimal if has_pv is true 20.0 PV panel area in m². Bedarfsausweis only.
pv_year_of_construction integer if has_pv is true 2022 Year of PV installation. Bedarfsausweis only.
has_solar boolean optional false Enables solar thermal fields (default: false)
solar_usage string if has_solar is true "warmwasser" warmwasser, heizung, warmwasser_heizung. Bedarfsausweis only.
solar_orientation string if has_solar is true "south" Solar panel orientation. Bedarfsausweis only.
solar_incline integer if has_solar is true 45 Solar panel inclination in degrees. Bedarfsausweis only.
solar_area float if has_solar is true 5.0 Solar thermal collector area in m². Bedarfsausweis only.
solar_year_of_construction integer if has_solar is true 2018 Year of solar thermal installation. Bedarfsausweis only.

Additional Building Parameters for Bedarfsausweis (geometry)

Parameter Type Required Example Description
shape string true "rectangle" rectangle, l_form, t_form
number_of_floors integer true 2 Number of floors
clear_room_height decimal true 2.7 Room height in meters
ceiling_thickness decimal optional 0.3 Ceiling thickness in meters (default: 0.30)
orientation_wall_a string true "north" Orientation of wall A: north, north_east, east, south_east, south, south_west, west, north_west
wall_a_length decimal true 10.0 Wall A length in meters
wall_b_length decimal true 8.0 Wall B length in meters
wall_c_length decimal if shape is l_form or t_form 5.0 Wall C length in meters
wall_d_length decimal if shape is l_form or t_form 4.0 Wall D length in meters
basement_type string false "none" none, unheated, partially_heated, heated. Default: none
basement_height decimal if basement_type is not none 2.10 Basement height in meters
basement_cellar_percentage integer if basement_type is not none 100 Percentage of building that is cellared (1-100). Default: 100
basement_heated_percentage integer if basement_type is partially_heated 60 Percentage of basement that is heated (1-99)
basement_wall_type string if basement_type is not none "massiv_hlz_hbl" Basement wall construction type. Same values as wall_type.
roof_type string true "satteldach" flachdach, satteldach, walmdach, pultdach
lower_completion_type string true "stahlbeton" stahlbeton, ziegel_holz, hohlraum_holz
wall_type string true "massiv_hlz_hbl" zweischalig_ohne_daemmung, zweischalig_mit_daemmung, massiv_bis_20cm, massiv_20_bis_30cm, massiv_ueber_30cm, massiv_hlz_hbl, massiv_sonstige_bis_20cm, massiv_sonstige_ueber_20cm, holzwand_mit_daemmung, fachwerkwand
window_type string true "holz_zwei_scheiben" holz_einfach_verglast, holz_zwei_scheiben, kunststoff_zweifach_verglast, alu_stahl_zweifach_verglast, dreifach_verglasung
window_year_of_construction integer false 1995 Year of window construction. If omitted, building year_of_construction is used.
has_radiator_niches boolean false false Whether radiator niches are present. Default: false
roller_shutter_box_type string false "none" Roller shutter box type: none, insulated, uninsulated. Default: none
airtightness string false "category_2" Airtightness category: category_1, category_2, category_3, category_4. Default: category_2
roof_construction_method string true "holzbauweise" Roof construction method: holzbauweise, massivbauweise
roof_ridge_wall string false "wall_a" Ridge direction: wall_a, wall_b. Default: wall_a. Only relevant for satteldach/pultdach
roof_attic_heated boolean false false Whether the attic is heated. Default: false
roof_height decimal false 2.5 Attic floor height in meters (Dachgeschosshöhe)
roof_jamb_height decimal false 0.8 Knee wall height in meters (Kniestockhöhe)
has_roof_window boolean false false Whether roof windows are present. Default: false
roof_window_type string if has_roof_window is true "kunststoff_zweifach_verglast" Roof window type. Same values as window_type.
roof_window_year_of_construction integer false 2005 Year of roof window construction
roof_window_area decimal if has_roof_window is true 3.5 Total roof window area in square meters

Consumption Parameters for Verbrauchsausweis

Parameter Type Required Example Description
year_1_started_at string true "2022-01-01" Start date for first consumption period (YYYY-MM-DD)
heating_1_year_1 decimal true 15000 Energy consumption year 1 (in system's energy_carrier_unit)
heating_1_year_2 decimal true 14500 Energy consumption year 2
heating_1_year_3 decimal true 14000 Energy consumption year 3
heating_2_year_1 decimal if system has_heating_2 5000 Energy consumption heating 2, year 1
heating_2_year_2 decimal if system has_heating_2 4800 Energy consumption heating 2, year 2
heating_2_year_3 decimal if system has_heating_2 4600 Energy consumption heating 2, year 3
heating_3_year_1 decimal if system has_heating_3 3000 Energy consumption heating 3, year 1
heating_3_year_2 decimal if system has_heating_3 2800 Energy consumption heating 3, year 2
heating_3_year_3 decimal if system has_heating_3 2600 Energy consumption heating 3, year 3
hot_water_type string true "heating_system" "heating_system", "separate", or "unknown"
hot_water_energy_carrier string if hot_water_type is "separate" "strom" Energy source for hot water
hot_water_energy_carrier_unit string if hot_water_type is "separate" "kwh" Unit for hot water energy carrier
hot_water_year_1 decimal if hot_water_type is "separate" 2000 Hot water consumption year 1
hot_water_year_2 decimal if hot_water_type is "separate" 2100 Hot water consumption year 2
hot_water_year_3 decimal if hot_water_type is "separate" 1900 Hot water consumption year 3
has_vacancy boolean optional false Enables vacancy correction (default: false)
vacancy_percentage_year_1 integer if has_vacancy is true 10 Vacancy percentage year 1 (0-100)
vacancy_percentage_year_2 integer if has_vacancy is true 15 Vacancy percentage year 2 (0-100)
vacancy_percentage_year_3 integer if has_vacancy is true 5 Vacancy percentage year 3 (0-100)
Example Request (Bedarfsausweis)
curl -X POST https://www.enausweis.de/api/v1/certifications \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certification": {
      "type": "bedarfsausweis",
      "reason": "sale",
      "street": "Musterstraße",
      "street_number": "1",
      "postal_code": "12345",
      "city": "Berlin",
      "building": {
        "building_type": "einfamilienhaus",
        "year_of_construction": 1990,
        "living_area": 120.0,
        "construction_method": "massivbauweise",
        "number_of_residential_units": 1
      },
      "envelope": {
        "roof_type": "satteldach",
        "roof_construction_method": "holzbauweise",
        "lower_completion_type": "stahlbeton",
        "wall_type": "massiv_hlz_hbl",
        "window_type": "kunststoff_zweifach_verglast"
      },
      "geometry": {
        "shape": "rectangle",
        "number_of_floors": 2,
        "clear_room_height": 2.7,
        "ceiling_thickness": 0.3,
        "orientation_wall_a": "north",
        "wall_a_length": 10.0,
        "wall_b_length": 8.0,
        "has_border_walls": true,
        "border_walls": ["b"]
      },
      "system": {
        "heating_1_generator": "brennwertkessel",
        "heating_1_emission_type": "heizkoerper",
        "heating_1_energy_carrier": "erdgas",
        "heating_1_energy_carrier_unit": "kwh",
        "ventilation_type": "fensterlueftung"
      }
    }
  }'
Example Request (Verbrauchsausweis with separate hot water)
curl -X POST https://www.enausweis.de/api/v1/certifications \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certification": {
      "type": "verbrauchsausweis",
      "reason": "sale",
      "street": "Musterstraße",
      "street_number": "1",
      "postal_code": "12345",
      "city": "Berlin",
      "building": {
        "building_type": "einfamilienhaus",
        "year_of_construction": 1990,
        "living_area": 120.0,
        "construction_method": "massivbauweise",
        "number_of_residential_units": 1,
        "has_thermal_glazing": true,
        "has_roof_insulation": false,
        "has_upper_completion_insulation": false,
        "has_wall_insulation": false,
        "has_basement_insulation": false
      },
      "system": {
        "heating_1_generator": "brennwertkessel",
        "heating_1_energy_carrier": "erdgas",
        "heating_1_energy_carrier_unit": "kwh",
        "ventilation_type": "fensterlueftung"
      },
      "consumption": {
        "year_1_started_at": "2022-01-01",
        "heating_1_year_1": 15000,
        "heating_1_year_2": 14500,
        "heating_1_year_3": 14000,
        "hot_water_type": "separate",
        "hot_water_energy_carrier": "strom",
        "hot_water_energy_carrier_unit": "kwh",
        "hot_water_year_1": 2000,
        "hot_water_year_2": 2100,
        "hot_water_year_3": 1900
      }
    }
  }'
Success Response (201 Created)
HTTP/1.1 201 Created
Location: https://www.enausweis.de/api/v1/certifications/42

{
  "id": 42,
  "type": "Bedarfsausweis",
  "reference_number": "CERT-2025-00042",
  "reason": "sale",
  "status": "draft",
  "mode": "live",
  "street": "Musterstraße",
  "street_number": "1",
  "postal_code": "12345",
  "city": "Berlin",
  "created_at": "2025-01-28T14:30:00Z",
  "energy_improvements_possible": null,
  "additional_notes": null,
  "api_url": "https://www.enausweis.de/api/v1/certifications/42",
  "building": { ... },
  "system": { ... },
  "envelope": { ... },
  "system": { ... },
  "geometry": { ... },
  "documents": []
}
Error Response (422 Unprocessable Entity)
{
  "errors": {
    "certification": {
      "reason": ["can't be blank"]
    },
    "building": {
      "wall_a_length": ["can't be blank"]
    },
    "system": {
      "heating_1_generator": ["can't be blank"]
    }
  }
}
PATCH /certifications/:id

Updates an existing energy certificate. Only certificates in draft status can be updated. Submitted, issued, or rejected certificates cannot be modified.

Path Parameters

Parameter Description
id The certification ID

Request Body Parameters

All parameters are optional. Only include the fields you want to update. The same parameters as for creating a certification are supported (see POST endpoint above).

Example Request (Update certification fields)
curl -X PATCH https://www.enausweis.de/api/v1/certifications/42 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certification": {
      "street": "Neue Straße",
      "street_number": "99"
    }
  }'
Example Request (Update building data)
curl -X PATCH https://www.enausweis.de/api/v1/certifications/42 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certification": {
      "building": {
        "living_area": 150.0,
        "year_of_construction": 1995
      }
    }
  }'
Success Response (200 OK)
{
  "id": 42,
  "type": "Bedarfsausweis",
  "reference_number": "CERT-2025-00042",
  "reason": "sale",
  "status": "draft",
  "mode": "live",
  "street": "Neue Straße",
  "street_number": "99",
  "postal_code": "12345",
  "city": "Berlin",
  "created_at": "2025-01-28T14:30:00Z",
  "energy_improvements_possible": null,
  "additional_notes": null,
  "api_url": "https://www.enausweis.de/api/v1/certifications/42",
  "building": { ... },
  "system": { ... },
  "documents": []
}
Error Response (422 - Certification already submitted)
{
  "errors": {
    "certification": {
      "status": ["cannot update a submitted, issued, or rejected certification"]
    }
  }
}
Error Response (422 - Validation failed)
{
  "errors": {
    "certification": {
      "postal_code": ["is invalid"]
    }
  }
}

Submissions

Submit a certification for issuance. This is the final step in the certification workflow — once submitted, the certificate data is handed over to Enausweis for calculation, registration at the DIBt, and issuance of the official energy certificate.

POST /certifications/:id/submission

Submits a certification for issuance.

Caution

  • After submission, the certification cannot be changed anymore.

Path Parameters

Parameter Description
id The ID of the certification to submit
Example Request
curl -X POST \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/certifications/CERTIFICATION_ID/submission
Response (201 Created)
{
  "id": "abc123",
  "type": "Verbrauchsausweis",
  "status": "draft",
  "submission": {
    "submitted_at": "2026-02-27T14:30:00Z"
  },
  ...
}
Error Response (422 - Not submittable)
{
  "errors": {
    "submission": [
      "certification is not ready for submission — all steps must be completed and status must be draft"
    ]
  }
}
Error Response (422 - Already submitted)
{
  "errors": {
    "submission": [
      "certification has already been submitted"
    ]
  }
}

Documents

Upload and manage documents for certifications. For Bedarfsausweis, heating system photos are required before issuance.

Allowed Categories by Certificate Type:

  • Bedarfsausweis: certification_image, heating_system (required), misc_images, misc
  • Verbrauchsausweis: certification_image
GET /certifications/:certification_id/documents

Returns all documents for a certification.

Path Parameters

Parameter Description
certification_id The certification ID
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/certifications/1/documents
Response
[
  {
    "id": 42,
    "api_url": "https://www.enausweis.de/api/v1/certifications/1/documents/42",
    "category": "heating_system",
    "category_name": "Bilder der Heizungsanlage",
    "filename": "heizkessel.jpg",
    "content_type": "image/jpeg",
    "byte_size": 102400,
    "download_url": "https://www.enausweis.de/verbrauchsausweis/{{TOKEN}}/dokumente/42",
    "created_at": "2025-01-15T10:30:00Z"
  }
]
GET /certifications/:certification_id/documents/:id

Returns a single document for a certification.

Path Parameters

Parameter Description
certification_id The certification ID
id The document ID
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/certifications/1/documents/42
Response
{
  "id": 42,
  "api_url": "https://www.enausweis.de/api/v1/certifications/1/documents/42",
  "category": "heating_system",
  "category_name": "Bilder der Heizungsanlage",
  "filename": "heizkessel.jpg",
  "content_type": "image/jpeg",
  "byte_size": 102400,
  "download_url": "https://www.enausweis.de/verbrauchsausweis/{{TOKEN}}/dokumente/42",
  "created_at": "2025-01-15T10:30:00Z"
}
POST /certifications/:certification_id/documents

Uploads a document for a certification. Use multipart/form-data encoding.

Path Parameters

Parameter Description
certification_id The certification ID

Form Parameters

Parameter Type Required Description
document[file] file Yes The file to upload (JPEG, PNG, or PDF, max 10MB)
document[category] string Yes Document category (see allowed values above)

Category Values

Value Name Max Files Accepted Types
certification_image Gebäudebild 1 JPEG, PNG
heating_system Bilder der Heizungsanlage 10 JPEG, PNG, PDF
misc_images Sonstige Bilder 10 JPEG, PNG
misc Sonstige Dokumente 10 JPEG, PNG, PDF
Example Request
curl -X POST \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "document[file]=@heizkessel.jpg" \
  -F "document[category]=heating_system" \
  https://www.enausweis.de/api/v1/certifications/1/documents
Response (201 Created)
{
  "id": 42,
  "api_url": "https://www.enausweis.de/api/v1/certifications/1/documents/42",
  "category": "heating_system",
  "category_name": "Bilder der Heizungsanlage",
  "filename": "heizkessel.jpg",
  "content_type": "image/jpeg",
  "byte_size": 102400,
  "download_url": "https://www.enausweis.de/verbrauchsausweis/{{TOKEN}}/dokumente/42",
  "created_at": "2025-01-15T10:30:00Z"
}

Error Response (422): If the category is not valid for the certification type:

{
  "errors": {
    "document": {
      "category": ["'heating_system' is not valid for Verbrauchsausweis. Allowed: certification_image"]
    }
  }
}
DELETE /certifications/:certification_id/documents/:id

Deletes a document from a certification.

Path Parameters

Parameter Description
certification_id The certification ID
id The document ID
Example Request
curl -X DELETE \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/certifications/1/documents/42
Response (204 No Content)

API Requests

View a history of your API requests for debugging and monitoring.

GET /api_requests

Returns a paginated list of your API request history.

Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/api_requests
Response
[
  {
    "id": 1,
    "endpoint": "/api/v1/certifications",
    "http_method": "GET",
    "request_payload": {},
    "response_status": 200,
    "error_message": null,
    "user_agent": "curl/8.1.0",
    "ip_address": "192.168.1.1",
    "duration_ms": 45,
    "created_at": "2025-01-28T10:30:00Z",
    "url": "https://www.enausweis.de/api/v1/api_requests/1"
  }
]
GET /api_requests/:id

Returns details of a single API request.

Path Parameters

Parameter Description
id The API request ID
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/api_requests/1

API Request Attributes

Attribute Type Description
id integer Unique identifier
endpoint string The requested API endpoint
http_method string HTTP method (GET, POST, etc.)
response_status integer HTTP response status code
error_message string Error message (if request failed)
duration_ms integer Request duration in milliseconds
created_at string ISO 8601 timestamp

Consumption Periods

Retrieve the available billing periods for a Verbrauchsausweis (consumption-based certificate). The available periods depend on climate factor data provided by the German Weather Service (DWD) and are updated monthly. Use this endpoint to determine which year_1_started_at values are valid when creating a certification.

GET /consumption_periods

Returns all available consumption billing periods. Each period represents a valid year_1_started_at value for the consumption data of a Verbrauchsausweis. The periods cover 3 consecutive years starting from the given date.

Response Fields

Field Type Description
start_date string The start date of the first billing year (ISO 8601 date, e.g. 2023-11-01). Use this as the year_1_started_at value.
end_date string The end date of the first billing year (ISO 8601 date, e.g. 2024-10-31)
label string Human-readable label for the billing period (e.g. November 23 - Oktober 24)
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/consumption_periods
Response
[
  {
    "start_date": "2023-11-01",
    "end_date": "2024-10-31",
    "label": "November 23 - Oktober 24"
  },
  {
    "start_date": "2023-10-01",
    "end_date": "2024-09-30",
    "label": "Oktober 23 - September 24"
  },
  {
    "start_date": "2023-09-01",
    "end_date": "2024-08-31",
    "label": "September 23 - August 24"
  }
]

Enums

Retrieve available enum values programmatically. Useful for building dynamic forms or validating input.

GET /enums/:enum_type

Returns all values for the specified enum type. Each entry contains a key (used in API requests) and a name (human-readable label).

Path Parameters

Parameter Description
enum_type The enum type in dasherized format (e.g. building-type, energy-carrier)

Available Enum Types

reason building-type construction-method commercial-usage shape orientation basement-type lower-completion-type wall-type window-type roller-shutter-box-type roof-type roof-construction-method heating-generator heating-emission-type energy-carrier energy-unit ventilation-type cooling-capacity hot-water-type hot-water-generator solar-usage document-category component-type modernization-combination
Example Request
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://www.enausweis.de/api/v1/enums/building-type
Response
[
  {
    "key": "einfamilienhaus",
    "name": "Einfamilienhaus"
  },
  {
    "key": "zweifamilienhaus",
    "name": "Zweifamilienhaus"
  },
  {
    "key": "mehrfamilienhaus",
    "name": "Mehrfamilienhaus"
  },
  ...
]

Objects

Certifications contain nested objects that represent different aspects of the building and certificate data. Below are the detailed attribute descriptions for each object type.

Partner Object

Returned by GET /api/v1/identity. Contains the authenticated partner's account information.

Attribute Type Description
id integer Unique identifier
company_name string Name of the partner company
contact_email string Contact e-mail address
contact_first_name string First name of the contact person
contact_last_name string Last name of the contact person
status string Account status (e.g. "active", "inactive")
dibt_self_service boolean Whether the partner manages DIBt registration themselves
dibt_username string | null DIBt portal username (only relevant when dibt_self_service is true)
dibt_password string | null Masked DIBt portal password
issuer_company_name string | null Optional company name shown for the issuer
created_at string ISO 8601 timestamp of account creation

Certification Object

Attribute Type Description
id integer Unique identifier
api_url string API URL to retrieve this certification
type string "Verbrauchsausweis" or "Bedarfsausweis"
reference_number string Unique reference number
partner_reference_number string Your own identifier for this building. Optional, but must be unique within your account
status string "draft", "submitted", "registered", "issued", or "rejected"
reason string Reason for certificate request (see values)
building object Building details (see below)
geometry object Building geometry data, only for Bedarfsausweis (see below)
envelope object Building envelope data, only for Bedarfsausweis (see below)
system object Heating and technical system data (see below)
consumption object Energy consumption data, only for Verbrauchsausweis (see below)
calculation object Calculation results, present after successful calculation (see below)
submission object Submission details (see below)
registration object DIBt registration details (see below)
preview object Preview URLs for HTML and PDF output (see below)
issuance object Issuance details (see below)
energy_improvements_possible boolean Whether cost-effective energy improvements are possible
additional_notes string Additional explanatory notes for the certificate (optional)
recommendations array Modernization recommendations (see below)

Building Object

Contains the basic building information required for the energy certificate calculation. Present for both Bedarfsausweis and Verbrauchsausweis certifications.

Attribute Type Description
building_type string Type of building (see values)
year_of_construction integer Year the building was constructed
living_area decimal Total living area in square meters
construction_method string Construction method (see values)
number_of_residential_units integer Number of residential units in the building
commercial_usage string Commercial usage type (see values)
has_thermal_glazing boolean Verbrauchsausweis only. Whether the building has thermal glazing (Wärmeschutzverglasung)
has_roof_insulation boolean Verbrauchsausweis only. Whether the building has roof insulation (Dachdämmung)
has_upper_completion_insulation boolean Verbrauchsausweis only. Whether the top floor ceiling is insulated with more than 12 cm (Oberste Geschossdecke gedämmt)
has_wall_insulation boolean Verbrauchsausweis only. Whether the building has exterior wall insulation or meets post-1977 thermal standards (Außenwanddämmung)
has_basement_insulation boolean Verbrauchsausweis only. Whether the building has basement ceiling or floor slab insulation (Kellerdecken-/Bodenplattendämmung)
confirms_waermeschutzverordnung_1977 boolean Verbrauchsausweis only. Whether the building was brought up to the insulation level of the Wärmeschutzverordnung 1977. Required for buildings with a year_of_construction before 1978 and at most 4 residential units – § 80 Abs. 3 GEG allows no Verbrauchsausweis for those otherwise. All four component groups must be reported alongside it: has_wall_insulation, has_thermal_glazing, has_basement_insulation and either has_roof_insulation or has_upper_completion_insulation.

System Object

Contains the heating system, cooling, and renewable energy information. Present when the certification has system data associated.

Attribute Type Description
heating_1_generator string Heating generator (see values)
heating_1_emission_type string Heat distribution method (see values). Bedarfsausweis only.
heating_1_energy_carrier string Primary energy carrier (see values)
heating_1_energy_carrier_unit string Unit for the energy carrier (see values)
heating_1_year_of_construction integer Year of heating system construction (optional)
heating_1_share_percentage integer Share of total heating in percent (default: 100). Automatically calculated when multiple heating systems are present. Bedarfsausweis only.
has_heating_2 boolean Whether a second heating system is present (default: false)
heating_2_generator string Second heating generator (see values). Only present when has_heating_2 is true.
heating_2_emission_type string Second heating distribution method (see values). Bedarfsausweis only. Only present when has_heating_2 is true.
heating_2_energy_carrier string Second energy carrier (see values). Only present when has_heating_2 is true.
heating_2_energy_carrier_unit string Unit for the second energy carrier (see values). Only present when has_heating_2 is true.
heating_2_year_of_construction integer Year of second heating system construction (optional). Only present when has_heating_2 is true.
heating_2_share_percentage integer Share of second heating in percent. Bedarfsausweis only. Only present when has_heating_2 is true.
has_heating_3 boolean Whether a third heating system is present (default: false). Requires has_heating_2 to be true.
heating_3_generator string Third heating generator (see values). Only present when has_heating_3 is true.
heating_3_emission_type string Third heating distribution method (see values). Bedarfsausweis only. Only present when has_heating_3 is true.
heating_3_energy_carrier string Third energy carrier (see values). Only present when has_heating_3 is true.
heating_3_energy_carrier_unit string Unit for the third energy carrier (see values). Only present when has_heating_3 is true.
heating_3_year_of_construction integer Year of third heating system construction (optional). Only present when has_heating_3 is true.
heating_3_share_percentage integer Share of third heating in percent. Bedarfsausweis only. Only present when has_heating_3 is true.
hot_water_included_in_heating boolean Whether hot water preparation is integrated into the heating system (default: true). Must be false when every heating generator is elektro_nachtspeicher or infrarot_elektro — these cannot produce hot water. Bedarfsausweis only.
hot_water_generator string Hot water generator type (see values). Bedarfsausweis only, when hot_water_included_in_heating is false.
hot_water_energy_carrier string Energy source for hot water (see values). Only present when hot_water_included_in_heating is false.
hot_water_energy_carrier_unit string Unit for the hot water energy carrier (see values). Only present when hot_water_included_in_heating is false.
hot_water_year_of_construction integer Year of construction of the hot water system. Only present when hot_water_included_in_heating is false.
ventilation_type string Ventilation system type (see values). Default: "fensterlueftung"
has_heated_basement boolean Whether a heated basement is present (default: false). Verbrauchsausweis only. Affects the Gebäudenutzfläche calculation for Einfamilienhaus and Zweifamilienhaus.
has_cooling boolean Whether a cooling system is installed (default: false)
cooling_capacity string Cooling capacity (see values). Only present when has_cooling is true.
cooling_cooled_area decimal Cooled area in m². Only present when has_cooling is true.
cooling_systems_count integer Number of cooling systems. Only present when has_cooling is true.
next_inspection_date date Next inspection due date. Only present when cooling_capacity is not less_than_12kw.
has_pv boolean Whether a photovoltaic system is installed (default: false)
pv_orientation string PV panel orientation (see values). Bedarfsausweis only, when has_pv is true.
pv_incline integer PV panel inclination in degrees. Bedarfsausweis only, when has_pv is true.
pv_area decimal PV panel area in m². Bedarfsausweis only, when has_pv is true.
pv_year_of_construction integer Year of PV system installation. Bedarfsausweis only, when has_pv is true.
has_solar boolean Whether a solar thermal system is installed (default: false)
solar_usage string Solar thermal usage type (see values). Bedarfsausweis only, when has_solar is true.
solar_orientation string Solar panel orientation (see values). Bedarfsausweis only, when has_solar is true.
solar_incline integer Solar panel inclination in degrees. Bedarfsausweis only, when has_solar is true.
solar_area float Solar thermal collector area in m². Bedarfsausweis only, when has_solar is true.
solar_year_of_construction integer Year of solar thermal system installation. Bedarfsausweis only, when has_solar is true.

Geometry Object

Contains the building geometry information required for Bedarfsausweis calculations. Present only for Bedarfsausweis certifications.

Attribute Type Description
shape string Building shape (see values)
number_of_floors integer Number of floors above ground
clear_room_height decimal Clear room height in meters (default: 2.70)
ceiling_thickness decimal Ceiling thickness in meters (default: 0.30)
orientation_wall_a string Orientation of wall A (see values)
wall_a_length decimal Wall A length in meters
wall_b_length decimal Wall B length in meters
wall_c_length decimal Wall C length in meters. Only present for l_form and t_form shapes.
wall_d_length decimal Wall D length in meters. Only present for l_form and t_form shapes.
wall_e_length decimal Wall E length in meters. Only present for t_form shape.
wall_f_length decimal Wall F length in meters. Only present for t_form shape.
has_border_walls boolean Whether the building has shared walls with neighboring buildings
border_walls array List of wall keys that are shared with neighbors (e.g., ["a", "c"]). Wall keys match the wall length fields (a, b, c, …). The legacy "wall_" prefix (e.g. "wall_a") is still accepted. Only present when has_border_walls is true.

Envelope Object

Contains the building envelope information (walls, windows, roof, basement) required for Bedarfsausweis calculations. Present only for Bedarfsausweis certifications.

Attribute Type Description
lower_completion_type string Lower completion construction type (see values)
wall_type string External wall construction type (see values)
window_type string Window type (see values)
window_year_of_construction integer Year of window construction (optional, defaults to building year)
has_roller_shutter_boxes boolean Whether roller shutter boxes are present (default: false)
roller_shutter_box_type string Roller shutter box type, required when has_roller_shutter_boxes is true (see values)
airtightness string Airtightness category (default: category_2) (see values)
has_radiator_niches boolean Whether radiator niches are present
later_insulation boolean Whether the building has been retrofitted with insulation (default: false)
later_insulation_wall_cm decimal Wall insulation thickness in cm. Only present when later_insulation is true. Must be >= 0.
later_insulation_roof_cm decimal Roof insulation thickness in cm. Only present when later_insulation is true. Must be >= 0.
later_insulation_upper_completion_cm decimal Upper floor slab insulation thickness in cm. Only present when later_insulation is true. Must be >= 0.
later_insulation_basement_wall_cm decimal Basement wall insulation thickness in cm. Only present when later_insulation is true. Must be >= 0.
later_insulation_lower_completion_cm decimal Floor slab insulation thickness in cm. Only present when later_insulation is true. Must be >= 0.
roof_type string Roof type (see values)
roof_construction_method string Roof construction method (see values)
roof_ridge_wall string Ridge direction ("wall_a", "wall_b"). Only relevant for satteldach/pultdach.
roof_attic_heated boolean Whether the attic is heated
roof_height decimal Attic floor height in meters. Only present when roof_attic_heated is true.
roof_jamb_height decimal Knee wall height in meters (Kniestockhöhe)
has_roof_window boolean Whether roof windows are present
roof_window_type string Roof window type (see values). Only present when has_roof_window is true.
roof_window_year_of_construction integer Year of roof window construction. Only present when has_roof_window is true.
roof_window_area decimal Total roof window area in m². Only present when has_roof_window is true.
basement_type string Basement type (see values)
basement_height decimal Basement height in meters. Only present when basement_type is heated, unheated, or partially_heated.
basement_cellar_percentage integer Percentage of building that is cellared (1-100). Only present when basement_type is heated, unheated, or partially_heated.
basement_heated_percentage integer Percentage of basement that is heated (1-99). Only present when basement_type is partially_heated.
basement_wall_type string Basement wall construction type (see values). Only present when basement_type is heated, unheated, or partially_heated.
lower_completion_adjacent_heated boolean True when the lowest floor borders a heated zone (e.g. heated commercial space below), so it is not part of the thermal envelope. Only possible without a basement. Set by Enausweis staff during review; it cannot be set through the API.

Consumption Object

Contains the energy consumption data required for Verbrauchsausweis calculations. Present only for Verbrauchsausweis certifications.

Attribute Type Description
year_1_started_at string Start date for the first consumption period (YYYY-MM-DD)
year_2_started_at string Start date for the second consumption period (calculated from year_1_started_at)
year_3_started_at string Start date for the third consumption period (calculated from year_1_started_at)
heating_1_year_1 decimal Energy consumption for heating in year 1 (in the unit specified by system's heating_1_energy_carrier_unit)
heating_1_year_2 decimal Energy consumption for heating in year 2
heating_1_year_3 decimal Energy consumption for heating in year 3
heating_2_year_1 decimal Energy consumption for heating 2 in year 1. Only present when system has_heating_2 is true.
heating_2_year_2 decimal Energy consumption for heating 2 in year 2. Only present when system has_heating_2 is true.
heating_2_year_3 decimal Energy consumption for heating 2 in year 3. Only present when system has_heating_2 is true.
heating_3_year_1 decimal Energy consumption for heating 3 in year 1. Only present when system has_heating_3 is true.
heating_3_year_2 decimal Energy consumption for heating 3 in year 2. Only present when system has_heating_3 is true.
heating_3_year_3 decimal Energy consumption for heating 3 in year 3. Only present when system has_heating_3 is true.
hot_water_type string How hot water is prepared (see values)
hot_water_energy_carrier string Energy source for separate hot water (see values). Only present when hot_water_type is "separate".
hot_water_energy_carrier_unit string Unit for hot water consumption (see values). Only present when hot_water_type is "separate".
hot_water_year_1 decimal Hot water consumption year 1. Only present when hot_water_type is "separate".
hot_water_year_2 decimal Hot water consumption year 2. Only present when hot_water_type is "separate".
hot_water_year_3 decimal Hot water consumption year 3. Only present when hot_water_type is "separate".
has_vacancy boolean Whether there was vacancy during the consumption periods
vacancy_percentage_year_1 integer Vacancy percentage for year 1 (0-100). Only present when has_vacancy is true.
vacancy_percentage_year_2 integer Vacancy percentage for year 2 (0-100). Only present when has_vacancy is true.
vacancy_percentage_year_3 integer Vacancy percentage for year 3 (0-100). Only present when has_vacancy is true.

Calculation Object

Contains the energy calculation results. Present when the certification has been successfully calculated.

Attribute Type Description
energy decimal Final energy demand/consumption in kWh/(m²·a)
primary_energy decimal Primary energy demand/consumption in kWh/(m²·a)
energy_efficiency_class string Energy efficiency class (A+ to H)
co2_emissions decimal CO₂ emissions in kg/(m²·a)

Submission Object

Contains submission details. Present when the certification has been submitted for processing.

Attribute Type Description
submitted_at string ISO 8601 timestamp when the certification was submitted

Registration Object

Contains DIBt registration details. Present when the certification has been successfully registered at the Deutsches Institut für Bautechnik (DIBt).

Attribute Type Description
dibt_number string The official DIBt registration number assigned to the certificate
dibt_username string The DIBt account username used for registration
registered_at string ISO 8601 timestamp when the certificate was registered at DIBt

Preview Object

Contains preview URLs. Present when the certification is calculatable and not yet issued.

Attribute Type Description
pdf_url string URL to open the certification preview as PDF.
html_url string URL to open the certification preview as HTML.

Issuance Object

Contains issuance details. Present when the energy certificate has been issued and is available.

Attribute Type Description
issued_at string ISO 8601 timestamp when the certificate was issued
pdf_url string | null URL to download the issued energy certificate PDF. null if the PDF is not yet available.
control_file_url string | null URL to download the DIBt Kontrolldatei (XML). null if the file is not yet available.

Recommendation Object

Contains modernization recommendations that appear on page 4 of the energy certificate. Recommendations are ordered by position.

Attribute Type Description
position integer Order position (1-based)
component_type string Building component (see values)
description string Description of the recommended measure (max 500 characters)
modernization_combination string Modernization type (see values)
estimated_amortization string Estimated payback period (optional, e.g., "8-12 Jahre")
estimated_cost_per_kwh string Estimated cost per saved kWh (optional, e.g., "0,05 €/kWh")

Document Object

Represents an uploaded document (image or PDF) attached to a certification.

Attribute Type Description
id integer Unique identifier
api_url string API URL to retrieve this document
category string Document category (see values)
category_name string Human-readable category name in German
filename string Original filename of the uploaded file
content_type string MIME type (image/jpeg, image/png, application/pdf)
byte_size integer File size in bytes
download_url string URL to download the file
created_at string ISO 8601 timestamp of when the document was uploaded

Enum Values

Many attributes accept predefined enum values. Domain-specific terms from German energy law and construction use German keys (e.g. brennwertkessel, erdgas), while generic concepts use English keys (e.g. sale, none). Below are all available enum values for each attribute. All enum values are also available programmatically via the Enums endpoint.

reason

Reason for requesting the energy certificate. Used in POST /certifications.

Endpoint: GET /enums/reason

Key Name
sale Verkauf oder Vermietung
modernization Modernisierung / Erweiterung
misc Sonstiges

building_type

Type of building. Used in Building.

Endpoint: GET /enums/building-type

Key Name
einfamilienhaus Einfamilienhaus
zweifamilienhaus Zweifamilienhaus
mehrfamilienhaus Mehrfamilienhaus
wohnteil_gemischt_genutztes_gebaeude Wohnteil gemischt genutztes Gebäude
beidseitig_angebautes_gebaeude Beidseitig angebautes Gebäude
einseitig_angebautes_gebaeude Einseitig angebautes Gebäude
sonstiges Sonstiges

construction_method

Construction method of the building. Used in Building.

Endpoint: GET /enums/construction-method

Key Name
massivbauweise Massivbauweise
holztafelbau_fertighaus Holztafelbau / Fertighaus
fachwerk Fachwerk

commercial_usage

Commercial usage classification. Used in Building.

Endpoint: GET /enums/commercial-usage

Key Name
residential Reines Wohngebäude
mixed_residential_like Mischgebäude (10–50 %), wohnungsähnlich
mixed_non_residential_like Mischgebäude (10–50 %), nicht wohnungsähnlich
mixed_commercial_dominant Mischgebäude (50–90 %), Gewerbe dominant
non_residential Nichtwohngebäude (> 90 % Gewerbe)

shape

Building shape. Used in Geometry (Bedarfsausweis only).

Endpoint: GET /enums/shape

Key Name
rectangle Rechteck
l_form L-Form
t_form T-Form

orientation

Compass orientation. Used in Geometry and System (for solar/PV).

Endpoint: GET /enums/orientation

Key Name
horizontal Horizontal
north Nord
north_east Nord-Ost
east Ost
south_east Süd-Ost
south Süd
south_west Süd-West
west West
north_west Nord-West

basement_type

Basement type. Used in Envelope (Bedarfsausweis only).

Endpoint: GET /enums/basement-type

Key Name
none Kein Keller
unheated unbeheizt
heated beheizt
partially_heated teilweise beheizt

lower_completion_type

Lower completion construction type. Used in Envelope (Bedarfsausweis only).

Endpoint: GET /enums/lower-completion-type

Key Name
stahlbeton Betondecke (Stahlbeton)
ziegel_holz Ziegel- oder Holzdecke
hohlraum_holz Holzbalkendecke mit Hohlraum

wall_type

External wall construction type. Used in Envelope (Bedarfsausweis only).

Endpoint: GET /enums/wall-type

Key Name Group
massiv_bis_20cm Mauerwerk, dünn (bis 20 cm) Mauerwerk
massiv_20_bis_30cm Mauerwerk, mittel (20-30 cm) Mauerwerk
massiv_ueber_30cm Mauerwerk, dick (über 30 cm) Mauerwerk
massiv_hlz_hbl Mauerwerk, Hochlochziegel / Hohlblocksteine Mauerwerk
zweischalig_ohne_daemmung Mauerwerk zweischalig (ohne Dämmung) Mauerwerk
zweischalig_mit_daemmung Mauerwerk zweischalig (mit Dämmung) Mauerwerk
massiv_sonstige_bis_20cm Betonwand, dünn (bis 20 cm) Beton
massiv_sonstige_ueber_20cm Betonwand, dick (über 20 cm) Beton
holzwand_mit_daemmung Holzständerwand (gedämmt) Holz & Fachwerk
fachwerkwand Fachwerkwand Holz & Fachwerk

window_type

Window type. Used in Envelope (Bedarfsausweis only).

Endpoint: GET /enums/window-type

Key Name
holz_einfach_verglast Einfachverglasung (Holzrahmen)
holz_zwei_scheiben Doppelverglasung (Holzrahmen)
kunststoff_zweifach_verglast Doppelverglasung (Kunststoffrahmen)
alu_stahl_zweifach_verglast Doppelverglasung (Alu-/Stahlrahmen)
dreifach_verglasung Dreifachverglasung

airtightness

Airtightness category. Used in Envelope (Bedarfsausweis only). Default: category_2.

Endpoint: GET /enums/airtightness

Key Name Ui description
category_2 Kategorie II Keine Mängel erkennbar - Fenster dicht, keine Zugluft, Türen schließen
category_3 Kategorie III Offensichtliche Undichtheiten - Zugluft, verzogene Fenster, undichte Haustür
category_4 Kategorie IV Schwere Undichtheiten - Offene Fugen, fehlende Dichtungen, Durchzug

roller_shutter_box_type

Roller shutter box type. Used in Envelope (Bedarfsausweis only). Only relevant when has_roller_shutter_boxes is true.

Endpoint: GET /enums/roller-shutter-box-type

Key Name
insulated Gedämmt
uninsulated Ungedämmt

roof_type

Roof type. Used in Envelope (Bedarfsausweis only).

Endpoint: GET /enums/roof-type

Key Name
flachdach Flachdach
satteldach Satteldach
walmdach Walmdach
pultdach Pultdach

roof_construction_method

Roof construction method. Used in Envelope (Bedarfsausweis only).

Endpoint: GET /enums/roof-construction-method

Key Name
holzbauweise Holz (Sparren/Pfetten)
massivbauweise Massiv (Betondecke)

heating_generator

Heating system type. Used in System (heating_1_generator, heating_2_generator, heating_3_generator).

Endpoint: GET /enums/heating-generator

Key Name Energy carriers
niedertemperaturkessel Niedertemperaturkessel ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]
brennwertkessel Brennwertkessel ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]
holzheizkessel Holzheizkessel ["brennholz", "holzhackschnitzel", "holzpellets"]
ofen_kamin Ofen/Kamin ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle", "brennholz", "holzhackschnitzel", "holzpellets"]
waermepumpe_luft Wärmepumpe (Luft) ["strom"]
waermepumpe_wasser Wärmepumpe (Wasser) ["strom"]
waermepumpe_erde Wärmepumpe (Erde) ["strom"]
etagenheizung Etagenheizung ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]
infrarot_elektro Infrarotheizung/Elektro-Direktheizgerät ["strom"]
elektro_nachtspeicher Elektro-Nachtspeicher ["strom"]
nah_fernwaerme Nah-/Fernwärme ["fernwaerme_kwk_erneuerbar", "fernwaerme_kwk_fossil", "fernwaerme_heizwerk", "fernwaerme_heizwerk_erneuerbar"]
standardkessel Konstanttemperaturkessel (Standardkessel) ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]

heating_emission_type

Heat distribution method. Bedarfsausweis only. Used in System (heating_1_emission_type, heating_2_emission_type, heating_3_emission_type).

Endpoint: GET /enums/heating-emission-type

Key Name
heizkoerper Heizkörper
fussbodenheizung Fußbodenheizung

energy_carrier

Energy source/carrier. Used in System (heating_1_energy_carrier, etc.) and Consumption.

Endpoint: GET /enums/energy-carrier

Key Name Unit keys
fernwaerme_kwk_erneuerbar Nah-/Fernwärme (KWK, erneuerbar) ["kwh"]
erdgas Erdgas H ["kwh", "m3"]
erdgas_l Erdgas L ["kwh", "m3"]
biogas Biogas ["kwh", "m3"]
fluessiggas Flüssiggas ["kwh", "kg", "liter"]
heizoel Heizöl ["kwh", "liter"]
biooel Bioöl ["kwh", "liter"]
steinkohle Steinkohle ["kwh", "kg"]
braunkohle Braunkohle ["kwh", "kg"]
brennholz Brennholz / Stückholz ["kwh", "raummeter", "kg"]
holzhackschnitzel Holzhackschnitzel ["kwh", "schuettraummeter", "kg"]
holzpellets Holzpellets ["kwh", "kg"]
fernwaerme_heizwerk Nah-/Fernwärme (Heizwerk, fossil) ["kwh"]
fernwaerme_heizwerk_erneuerbar Nah-/Fernwärme (Heizwerk, erneuerbar) ["kwh"]
strom Strom ["kwh"]
fernwaerme_kwk_fossil Nah-/Fernwärme (KWK, fossil) ["kwh"]

energy_unit

Energy consumption unit. Used in System and Consumption. Available units depend on the selected energy_carrier.

Endpoint: GET /enums/energy-unit

Key Name
kwh kWh
m3 m³
liter l
kg kg
raummeter RM
schuettraummeter SRM

ventilation_type

Ventilation system type. Used in System.

Endpoint: GET /enums/ventilation-type

Key Name
fensterlueftung Fensterlüftung
schachtlueftung Schachtlüftung
lueftungsanlage_ohne_waermerueckgewinnung Lüftungsanlage
lueftungsanlage_mit_waermerueckgewinnung Lüftungsanlage

cooling_capacity

Cooling system capacity. Used in System (when has_cooling is true).

Endpoint: GET /enums/cooling-capacity

Key Name
less_than_12kw Weniger als 12 kW
greater_than_12kw_without_automation 12 kW oder mehr (ohne Gebäudeautomation)
greater_than_12kw_with_automation 12 kW oder mehr (mit Gebäudeautomation)
greater_than_70kw Klimaanlage größer als 70 kW

hot_water_type

Hot water preparation type. Used in Consumption (Verbrauchsausweis only).

Endpoint: GET /enums/hot-water-type

Key Name
heating_system Heizungsanlage
separate Separat
unknown Separat / Unbekannt

hot_water_generator

Hot water generator type. Used in System (Bedarfsausweis only, when hot_water_included_in_heating is false).

Endpoint: GET /enums/hot-water-generator

Key Name Energy carriers
niedertemperaturkessel Niedertemperaturkessel ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]
brennwertkessel Brennwertkessel ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]
holzheizkessel Holzheizkessel ["brennholz", "holzhackschnitzel", "holzpellets"]
abluft_waermepumpe Abluft-Wärmepumpe ["strom"]
nah_fernwaerme Nah-/Fernwärme ["fernwaerme_kwk_erneuerbar", "fernwaerme_kwk_fossil", "fernwaerme_heizwerk", "fernwaerme_heizwerk_erneuerbar"]
blockheizkraftwerk Blockheizkraftwerk (BHKW) ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle", "brennholz", "holzhackschnitzel", "holzpellets"]
elektro_durchlauferhitzer Elektro-Durchlauferhitzer ["strom"]
elektro_boiler Elektroboiler / Elektro-Warmwasserspeicher ["strom"]
gas_durchlauferhitzer Gas-Durchlauferhitzer ["erdgas", "erdgas_l"]
frischwasserstation Frischwasserstation / Wohnungsstation ["fernwaerme_kwk_erneuerbar", "erdgas", "erdgas_l", "biogas", "fluessiggas", "heizoel", "biooel", "steinkohle", "braunkohle", "brennholz", "holzhackschnitzel", "holzpellets", "fernwaerme_heizwerk", "fernwaerme_heizwerk_erneuerbar", "strom", "fernwaerme_kwk_fossil"]
standardkessel Konstanttemperaturkessel (Standardkessel) ["erdgas", "erdgas_l", "heizoel", "fluessiggas", "biogas", "biooel", "steinkohle", "braunkohle"]

solar_usage

Solar thermal usage type. Used in System (Bedarfsausweis only, when has_solar is true).

Endpoint: GET /enums/solar-usage

Key Name
warmwasser Warmwasser
heizung Heizung
warmwasser_heizung Warmwasser und Heizung

document_category

Document category for uploads. Used in POST /certifications/:id/documents.

Endpoint: GET /enums/document-category

Key Name Available for
certification_imageGebäudebildBoth
heating_systemBilder der HeizungsanlageBedarfsausweis only
misc_imagesSonstige BilderBedarfsausweis only
miscSonstige DokumenteBedarfsausweis only

component_type

Building component type for recommendations. Used in Recommendation.

Endpoint: GET /enums/component-type

Key Name
dach Dach
oberste_geschossdecke Oberste Geschossdecke
abseiten Abseiten
gauben Gauben
dachfenster Dachfenster
aussenwand Außenwand gg. Außenluft
fenster Fenster
rolllaeden Rollläden und -kästen
eingangstuer Eingangstür
nebentuer Nebentür
kellerdecke Kellerdecke
boden_aussenluft Boden gg. Außenluft
aussenwand_erdreich Außenwand gg. Erdreich
boden_erdreich Boden gegen Erdreich
luftundichtigkeiten Luftundichtigkeiten
heizung Heizung
waermeerzeuger Wärmeerzeuger
waermeverteilung Wärmeverteilung / -abgabe
warmwasser Warmwasserbereitung
lueftung Lüftung
lueftungskonzept Lüftungskonzept
lueftungsanlage Lüftungsanlage
luftverteilung Luftverteilung / -abgabe
kuehlung Kühlung
kaelteerzeugung Kälteerzeugung
kaelteverteilung Kälteverteilung / -abgabe
befeuchtung Be-/Entfeuchtung
beleuchtung Beleuchtung
anlagenregelung Anlagenregelung
gebaeudeautomation Gebäudeautomation
sonstiges Sonstiges

modernization_combination

Modernization measure combination type. Used in Recommendation.

Endpoint: GET /enums/modernization-combination

Key Name
single_measure Als Einzelmaßnahme
larger_modernization Im Zusammenhang mit größerer Modernisierung

Changelog

Notable changes to the API. Backwards-compatible changes are made without notice; breaking changes are announced here in advance.

Date Change
2026-11-04 The API now allows up to 120 requests per minute per partner. Beyond that it answers with 429 Too Many Requests and a Retry-After header. Refused requests do not appear in the API request log.
2026-11-03 The heating combination rules of a Bedarfsausweis from 2026-10-26 are replaced by a single one: when a building has more than one heating, at least one of them must be a central heating, i.e. not all of them may be ofen_kamin, infrarot_elektro or elektro_nachtspeicher, whatever the energy carrier. Such a request is answered with a validation error on heating_2_generator; merge them into one heating. This now also rejects an ofen_kamin with a wood energy carrier next to infrarot_elektro or elektro_nachtspeicher. In return, an ofen_kamin with a wood energy carrier is accepted again as one of three heatings, and two single-room heaters are accepted as heating 1 and 2 when heating 3 is a central heating. nah_fernwaerme is still accepted only once.
2026-10-26 Due to calculation incompatibilities, system.hot_water_generator: frischwasserstation is no longer accepted when heating_1_generator is ofen_kamin, infrarot_elektro or elektro_nachtspeicher. The station draws its heat from heating 1, so a central generator has to be heating 1. Such a request is answered with a validation error on hot_water_generator.
2026-10-26 Due to calculation incompatibilities, some generator pairs are no longer accepted as system.heating_1_generator and heating_2_generator of a Bedarfsausweis: two of infrarot_elektro, elektro_nachtspeicher and ofen_kamin with a non-wood energy carrier; two ofen_kamin with a wood energy carrier (brennholz, holzhackschnitzel, holzpellets). Such a request is answered with a validation error on heating_2_generator. Merge both into one heating, or, with three heatings, swap one of them with heating_3_generator. nah_fernwaerme is accepted only once across all three heatings; a second one is answered with a validation error on its generator.
2026-10-26 Due to calculation incompatibilities, a Bedarfsausweis with three heatings (system.has_heating_3: true) no longer accepts ofen_kamin with a wood energy carrier (brennholz, holzhackschnitzel, holzpellets) as any of them. Such a request is answered with a validation error on that heating's generator. With one or two heatings, or with another energy carrier, the stove is accepted as before.
2026-10-26 system.heating_2_share_percentage and heating_3_share_percentage together must now leave at least 1 for heating_1_share_percentage, which is calculated as the remainder. Shares adding up to 100 or more were accepted before and left heating 1 with zero or a negative share; such a request is now answered with a validation error.
2026-09-28 The request log behind GET /api/v1/api_requests changed in two ways. Requests answered with 400 or 404 are logged too — they were missing before and are now also counted towards the call count. And a log entry is kept for 90 days; older entries are deleted, so a partner that archives its calls should fetch them within that window. Everything else about the log is unchanged: endpoint is still the path without the query string, and request_payload still holds the request body alone.
2026-09-28 items is capped at 100 per page and defaults to 20. A larger value is no longer refused but reduced, so a request that asked for more now returns one page of 100 and says so in Page-Limit; Total-Count is unchanged and the remaining pages are fetched with page as before.
2026-09-27 status now reports issued only once the certificate has actually been issued. A certification whose issuance failed reported issued although no PDF existed; it now reports the state it is really in, usually registered. No field was added or removed, and a successfully issued certificate is unaffected.
2026-09-16 § 80 Abs. 3 GEG restricts the Verbrauchsausweis for small older buildings. A residential building with a building.year_of_construction before 1978 and at most 4 building.number_of_residential_units is now rejected with a validation error unless the new field building.confirms_waermeschutzverordnung_1977: true is sent, together with all four component groups: has_wall_insulation, has_thermal_glazing, has_basement_insulation and either has_roof_insulation or has_upper_completion_insulation. Send a Bedarfsausweis for those buildings otherwise. The field is returned on every Verbrauchsausweis response and is ignored for the Bedarfsausweis. Certifications created before this change are unaffected, and the restriction itself lapses on 01.01.2027.
2026-08-05 Electric direct heating cannot produce hot water. When every heating generator is elektro_nachtspeicher or infrarot_elektro, system.hot_water_included_in_heating: true is rejected with a validation error. Send false together with a separate hot_water_generator such as elektro_durchlauferhitzer or elektro_boiler. Combinations that also contain a non-electric generator are unaffected, as are certifications created before this change. Bedarfsausweis only.
2026-08-05 New optional field partner_reference_number on the certification object. Use it to store your own identifier for a building. It is accepted on POST /certifications and PATCH /certifications/:id, and returned on every certification response. Values must be unique within your account; a duplicate is rejected with a validation error. Existing integrations are unaffected.
2026-08-04 Due to calculation incompatibilities, the ground, water and air source heat pumps are no longer available for domestic hot water only. They were removed from the hot_water_generator enum and are no longer accepted for system.hot_water_generator. Use hot_water_included_in_heating: true or a dedicated generator such as abluft_waermepumpe. They remain selectable as heating generators (system.heating_1_generator, heating_2_generator, heating_3_generator).
2026-06-19 geometry.border_walls now uses the bare wall keys ("a", "b", …) that match the wall length fields. The previously documented "wall_" prefix is still accepted, so no change is required for existing integrations.

Hilfe & Kontakt

Formular wird geladen…