Så fungerar Boverkets API för energideklarationer

Boverkets API är ett verktyg som låter er som företag hämta grundläggande information, så kallade basuppgifter, från energideklarationsregistret. Detta gör det enklare att integrera informationen i företagets egna system.

Vad kan vi få fram?

Ni kan, via API:et, få tillgång till följande uppgifter om en byggnad:

• Energiklass (A-G)
• Energideklarations-ID
• Energiprestanda (primärenergital)
• Specifik energianvändning
• Om radonmätning och ventilationskontroll är utförd
• Datum då energideklarationen gjordes.

API:et tillhandahåller endast denna grundläggande information, så kallade "basuppgifter". Detta beror på att lagar och regler sätter gränser för vilken data som får delas.

Hur används API:et?

API:et är ett så kallat REST-API och används för att hämta information med en GET-metod. För att göra en sökning behöver ni ange:

1. Kommunens namn
2. Antingen fastighetsbeteckningen eller adressen till byggnaden.

Exempel på sökning

GET https://api.boverket.se/energideklarationer/?kommun=Stockholm&fastighetsbeteckning=HELGEANDSHOLMEN%201

Ni får ett svar i form av en JSON-fil, med information om byggnaden. Se detta exempel, med fiktiva data:

"energideklarationer": [{
    "id": 123456789,
    "energiklass": "E",
    "primarenergital": "216 kWh/m² och år",,
    "energiprestanda": "130 kWh/m² och år",
    "radonmatning": "Inte utförd",
    "ventilationskontroll": "Utförd",
    "byggnadsar": null,
    "utford": "2021-01-01",
    "fastigheter": [{
        "kommun": "Stockholm",
        "fastighetsbeteckning": "HELGEANDSHOLMEN 1",
        "adresser": [{
            "adress": "Riksgatan 1",
            "postnummer": "11128",
            "postort": "Stockholm"
      }]

Vad är ett REST-API?

Ett REST-API är ett gränssnitt som gör det möjligt för olika program att kommunicera och utbyta data via internet. Boverkets API använder GET-metoden för att hämta information.

Begränsningar

Det finns begränsningar för hur ni kan använda e-tjänsten:

• Max 10 anrop per 2 sekunder.
• Max 1 500 anrop per dag.
• Max 40 000 kilobyte data per dag.

Servicefönster

Varje morgon mellan kl. 06:00 och 06:15 uppdateras databasen, och under denna tid kan ni inte använda API:et.