{"id":"energimerking","name":"Enova Energy Certificates","description":"Energy certificates (energiattester) for Norwegian buildings, looked up by address or property, plus the yearly energy-label distribution for a municipality.","documentation":"https://www.energimerking.no/","operations":[{"name":"get_energy_certificates","description":"Every energy certificate for one property. Signature: get_energy_certificates(address: string, optional, default None; municipality_number: string, optional, default None; gnr: integer, optional, default None; bnr: integer, optional, default None; fnr: integer, optional, default None; snr: integer, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","signature":"get_energy_certificates(address: string, optional, default None; municipality_number: string, optional, default None; gnr: integer, optional, default None; bnr: integer, optional, default None; fnr: integer, optional, default None; snr: integer, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)","parameters":[{"name":"address","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Street address, e.g. \"Kirkeveien 64A, Oslo\". Resolved to a municipality/gnr/bnr; the matched address is echoed back.","unit":null,"display_type":"string"},{"name":"municipality_number","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"4-digit municipality code, e.g. \"0301\". Needed with gnr and bnr when no address is given.","unit":null,"display_type":"string"},{"name":"gnr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Gardsnummer (farm number) of the property.","unit":null,"display_type":"integer"},{"name":"bnr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Bruksnummer (property number) of the property.","unit":null,"display_type":"integer"},{"name":"fnr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Optional festenummer (leasehold number), when above 0.","unit":null,"display_type":"integer"},{"name":"snr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Optional seksjonsnummer (section number), when above 0.","unit":null,"display_type":"integer"},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100).","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates?address={address}&municipality_number={municipality_number}&gnr={gnr}&bnr={bnr}&fnr={fnr}&snr={snr}&limit=25&offset=0","output_fields":["matched_address","matched_address.address","matched_address.postal_code","matched_address.postal_place","matched_address.municipality","matched_address.municipality_number","matched_address.gnr","matched_address.bnr","matched_address.fnr","municipality_number","gnr","bnr","count","certificates","certificates[].certificate_id","certificates[].issued","certificates[].energy_label","certificates[].heating_label","certificates[].building_category","certificates[].building_type","certificates[].year_built","certificates[].usable_area_m2","certificates[].address","certificates[].postal_code","certificates[].postal_place","certificates[].building_number","certificates[].unit_number","certificates[].section_number","certificates[].delivered_energy_kwh_per_m2","certificates[].delivered_energy_kwh"],"output_fields_truncated":true,"canonical_field_aliases":{},"description_language":"en","documentation":"Every energy certificate for one property.\n\nA property is identified either by a free-text address (resolved via the\nGeonorge address API) or by municipality number together with gnr and bnr\n(gardsnummer and bruksnummer). A property can have several certificates\n(several buildings or sections), so the result is a list.\n\nArgs:\n    address: Street address, e.g. \"Kirkeveien 64A, Oslo\". Resolved to a\n        municipality/gnr/bnr; the matched address is echoed back.\n    municipality_number: 4-digit municipality code, e.g. \"0301\". Needed\n        with gnr and bnr when no address is given.\n    gnr: Gardsnummer (farm number) of the property.\n    bnr: Bruksnummer (property number) of the property.\n    fnr: Optional festenummer (leasehold number), when above 0.\n    snr: Optional seksjonsnummer (section number), when above 0.\n\nReturns `municipality_number`, `gnr`, `bnr`, `count` and `certificates`\nsorted newest first. `matched_address` is included only for an address\nlookup. Each certificate has certificate_id, issued, energy_label (A-G),\nheating_label, building_category, building_type, year_built,\nusable_area_m2, address, postal_code, postal_place, building_number,\nunit_number, section_number, delivered_energy_kwh_per_m2,\ndelivered_energy_kwh, fossil_share, registration_type,\norganization_number and pdf_url.\n\nData: Enova (energiattest register).\n\nSignature: get_energy_certificates(address: string, optional, default None; municipality_number: string, optional, default None; gnr: integer, optional, default None; bnr: integer, optional, default None; fnr: integer, optional, default None; snr: integer, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/energimerking/get_energy_certificates/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/energimerking/get_energy_certificates/?address={address}&municipality_number={municipality_number}&gnr={gnr}&bnr={bnr}&fnr={fnr}&snr={snr}&limit=25&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates","response_schema":{"type":"object","properties":{"matched_address":{"type":"object","properties":{"address":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"postal_place":{"type":["string","null"]},"municipality":{"type":["string","null"]},"municipality_number":{"type":["string","null"]},"gnr":{"type":["integer","null"]},"bnr":{"type":["integer","null"]},"fnr":{"type":["integer","null"]}},"additionalProperties":false},"municipality_number":{"type":["string","null"]},"gnr":{"type":["integer","null"]},"bnr":{"type":["integer","null"]},"count":{"type":"integer"},"certificates":{"type":"array","items":{"type":"object","properties":{"certificate_id":{"type":["string","null"]},"issued":{"type":["string","null"],"format":"date"},"energy_label":{"type":["string","null"]},"heating_label":{"type":["string","null"]},"building_category":{"type":["string","null"]},"building_type":{"type":["string","null"]},"year_built":{"type":["integer","null"]},"usable_area_m2":{"type":["number","null"]},"address":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"postal_place":{"type":["string","null"]},"building_number":{"type":["string","null"]},"unit_number":{"type":["string","null"]},"section_number":{"type":["string","null"]},"delivered_energy_kwh_per_m2":{"type":["number","null"]},"delivered_energy_kwh":{"type":["number","null"]},"fossil_share":{"type":["number","null"]},"registration_type":{"type":["string","null"]},"organization_id":{"type":["string","null"]},"pdf_url":{"type":["string","null"],"format":"uri"}},"additionalProperties":false}}},"additionalProperties":false,"required":["municipality_number","gnr","bnr","count","certificates"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["organization"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates?address={address}&municipality_number={municipality_number}&gnr={gnr}&bnr={bnr}&fnr={fnr}&snr={snr}&limit=25&offset=0","response_example":{"source":"energimerking","operation":"get_energy_certificates","parameters":{"address":"example value","municipality_number":"example value","gnr":1,"bnr":1,"fnr":1,"snr":1},"data":{"matched_address":{"address":"example value","postal_code":"example value","postal_place":"example value","municipality":"example value","municipality_number":"example value","gnr":1,"bnr":1,"fnr":1},"municipality_number":"example value","gnr":1,"bnr":1,"count":1,"certificates":[{"certificate_id":"example-id","issued":"2026-01-15","energy_label":"example value","heating_label":"example value","building_category":"example value","building_type":"example value","year_built":1,"usable_area_m2":1.0,"address":"example value","postal_code":"example value","postal_place":"example value","building_number":"example value","unit_number":"example value","section_number":"example value","delivered_energy_kwh_per_m2":1.0,"delivered_energy_kwh":1.0,"fossil_share":1.0,"registration_type":"example value","organization_id":"example-id","pdf_url":"https://example.invalid/resource"}]},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"energimerking","name":"Enova Energy Certificates","description":"Energy certificates (energiattester) for Norwegian buildings, looked up by address or property, plus the yearly energy-label distribution for a municipality.","cache_ttl_seconds":86400,"documentation":"https://www.energimerking.no/"}]},"_provenance":{"data":{"source":"energimerking","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking"},"entities":{"source":"energimerking","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates","source":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","wiki":"https://allemannsdata.com/wiki/kilder/energimerking/get_energy_certificates/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}},{"name":"energy_label_stats","description":"Energy-label distribution for one municipality and year. Signature: energy_label_stats(municipality_number: string, required; year: integer, calendar year, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","signature":"energy_label_stats(municipality_number: string, required; year: integer, calendar year, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)","parameters":[{"name":"municipality_number","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"4-digit municipality code, e.g. \"0301\".","unit":null,"display_type":"string"},{"name":"year","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Calendar year of issue, 2010-2025 (default: last year). From 2026 the data moved to an incompatible bank API and is not available here. Unit: calendar year.","unit":"calendar year","display_type":"integer"},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100).","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/energy_label_stats?municipality_number={municipality_number}&year={year}&limit=25&offset=0","output_fields":["municipality_number","year","total","mean_delivered_energy_kwh_per_m2","energy_labels","heating_labels","categories","categories[].category","categories[].count","categories[].energy_labels"],"output_fields_truncated":false,"canonical_field_aliases":{},"description_language":"en","documentation":"Energy-label distribution for one municipality and year.\n\nCounts the certificates issued in one calendar year in one municipality,\nfrom Enova's yearly bulk file. The first call for a year downloads about\n50 MB (5 to 20 seconds); later calls for that year are instant. Each\ndwelling unit has its own certificate, so blocks of flats count every flat,\nand bulk issuance by housing cooperatives can make one year spike (Oslo\n2025: about 127 000, mostly apartments).\n\nArgs:\n    municipality_number: 4-digit municipality code, e.g. \"0301\".\n    year: Calendar year of issue, 2010-2025 (default: last year). From\n        2026 the data moved to an incompatible bank API and is not\n        available here.\n\nReturns `municipality_number`, `year`, `total`, `mean_delivered_energy_kwh_per_m2`\n(1 decimal, or null), `energy_labels` (counts for A to G, always all seven\nkeys), `heating_labels` (counts per colour) and `categories` (one entry per\nbuilding category, most common first, each with its own label counts). A\nmunicipality with no certificates returns total 0 and empty categories.\n\nData: Enova (energiattest register), yearly bulk file.\n\nSignature: energy_label_stats(municipality_number: string, required; year: integer, calendar year, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/energimerking/energy_label_stats/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/energimerking/energy_label_stats/?municipality_number={municipality_number}&year={year}&limit=25&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/energy_label_stats","response_schema":{"type":"object","properties":{"municipality_number":{"type":["string","null"]},"year":{"type":"integer"},"total":{"type":"integer"},"mean_delivered_energy_kwh_per_m2":{"type":["number","null"]},"energy_labels":{"type":"object","additionalProperties":{"type":"integer"}},"heating_labels":{"type":"object","additionalProperties":{"type":"integer"}},"categories":{"type":"array","items":{"type":"object","properties":{"category":{"type":["string","null"]},"count":{"type":"integer"},"energy_labels":{"type":"object","additionalProperties":{"type":"integer"}}},"additionalProperties":false,"required":["category","count","energy_labels"]}}},"additionalProperties":false,"required":["municipality_number","year","total","mean_delivered_energy_kwh_per_m2","energy_labels","heating_labels","categories"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["organization"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/energy_label_stats/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/energy_label_stats","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/energy_label_stats?municipality_number={municipality_number}&year={year}&limit=25&offset=0","response_example":{"source":"energimerking","operation":"energy_label_stats","parameters":{"municipality_number":"example value","year":1},"data":{"municipality_number":"example value","year":1,"total":1,"mean_delivered_energy_kwh_per_m2":1.0,"energy_labels":{"example_key":1},"heating_labels":{"example_key":1},"categories":[{"category":"example value","count":1,"energy_labels":{"example_key":1}}]},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"energimerking","name":"Enova Energy Certificates","description":"Energy certificates (energiattester) for Norwegian buildings, looked up by address or property, plus the yearly energy-label distribution for a municipality.","cache_ttl_seconds":86400,"documentation":"https://www.energimerking.no/"}]},"_provenance":{"data":{"source":"energimerking","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking"},"entities":{"source":"energimerking","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/energy_label_stats","source":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","wiki":"https://allemannsdata.com/wiki/kilder/energimerking/energy_label_stats/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}],"operation_schema_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/{operation}/schema","related_sources":[{"id":"geonorge","name":"Geonorge","reason":"Address search and coordinates behind the address lookups.","api":"https://allemannsdata.com/wiki/api/v1/kilder/geonorge","wiki":"https://allemannsdata.com/wiki/kilder/geonorge/"},{"id":"elhub","name":"Elhub energy data","reason":"Measured electricity consumption per municipality, to set against the energy labels.","api":"https://allemannsdata.com/wiki/api/v1/kilder/elhub","wiki":"https://allemannsdata.com/wiki/kilder/elhub/"}],"_meta":{"retrieved_at":"2026-10-11T09:31:13Z","language":"en","content_languages":["en"],"sources":[{"id":"energimerking","name":"Enova Energy Certificates","description":"Energy certificates (energiattester) for Norwegian buildings, looked up by address or property, plus the yearly energy-label distribution for a municipality.","documentation":"https://www.energimerking.no/","cache_ttl_seconds":86400}]},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","names":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking?view=names","compact":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking?view=compact","full":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","wiki":"https://allemannsdata.com/wiki/kilder/energimerking/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}
