Hur fungerar Boverkets API för energideklarationer?

Granskad: 11 oktober 2024

Boverkets API är utvecklat för att företag lättare ska kunna få tillgång till vissa uppgifter i energideklarationsregistret som behövs i deras verksamhet. Dessa begränsade uppgifter kallas för basuppgifter.

Basuppgifter

Följande basuppgifter kan hämtas för en byggnad:

  • energiklass,
  • energideklarations-ID,
  • energiprestanda (primärenergital),
  • specifik energianvändning (det som tidigare var energiprestanda),
  • om radonmätning och ventilationskontroll är utförd, samt
  • när energideklarationen är utförd.

REST API

REST-API:et har bara en funktion – att hämta information om energideklarationer. För att använda denna funktion:

  1. använder du en GET-metod, vilket betyder att du ber om att få information.
  2. måste du ange vilken kommun du är intresserad av.
  3. måste du också ange antingen fastighetsbeteckningen eller adressen för byggnaden.

Exempel på anrop (notera att detta är fiktiva data):

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

Svaret returneras i form av en JSON-fil, se exempel nedan:

"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 möjliggör kommunikation mellan olika program och tjänster över internet. Det använder HTTP-protokollet och standardiserade metoder (som GET, POST, PUT, DELETE) för att utföra operationer på resurser. Boverkets API för energideklarationer har endast en GET-metod för att hämta information om energideklarationer

Begränsningar

Det finns begränsningar för antalet anrop respektive användare av API:t kan genomföra. Dessa är satta till:

  • 10 anrop per 2 sekunder
  • 1500 anrop per dygn
  • 40 000 kilobyte data per dygn

Löpande servicefönster

Varje morgon mellan klockan 06:00 och ca 06:15 uppdateras API:ets databas med ny information. Under denna tid levererar inte API:et någon information om energideklarationerna.