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 samt A0)
• energideklarations-ID
• energiprestanda (primärenergital)
• energiprestanda (Specifik energianvändning)
• energiprestandatal
• om radonmätning och ventilationskontroll är utförda
• datum då energideklarationen gjordes
• datum då energideklarationen uppdaterades.

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": "A0",
    "primarenergital": "216 kWh/m² och år",,
    "energiprestanda": "130 kWh/m² och år",
    "energiprestandatal": "116 kWh/m² och år",
    "radonmatning": "Inte utförd",
    "ventilationskontroll": "Utförd",
    "utford": "2021-01-01",
    "uppdaterad": "2021-01-02",
    "giltighet": "10",
    "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.