{"source":"energimerking","operation":"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},{"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},{"name":"gnr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Gardsnummer (farm number) of the property.","unit":null},{"name":"bnr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Bruksnummer (property number) of the property.","unit":null},{"name":"fnr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Optional festenummer (leasehold number), when above 0.","unit":null},{"name":"snr","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Optional seksjonsnummer (section number), when above 0.","unit":null},{"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","schema_scope":"#/data in the successful operation envelope","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."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"},"feedback":{"type":"string","format":"uri"}},"required":["self","api_index","feedback"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"503":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking/get_energy_certificates","source":"https://allemannsdata.com/wiki/api/v1/kilder/energimerking","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"},"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":{},"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"}}}