Skip to content

← API reference

Typical household energy use in the address's county

household_energy_baseline17 fields17 of these fields open in the demo
Source
SSB 14578 and 14580 (Husholdningenes energibruk)
Geography
region
Reported stale after
2200 days
Access
Requires an API key granted this section
Contract version
1
In packages
area_context

What this does not say

Quoted verbatim from the section’s warnings field, exactly as the API returns it. They are not translated: a translation would show something other than what your response actually contains.

  • An average over a sample of households in the county from SSB's energy survey, which runs every few years (survey_year says which); it is a baseline to compare a bill or an energy certificate against, not a measurement of this dwelling.
  • Published only for the 2020-2023 counties: an address in Østfold, Akershus or Buskerud reads Viken, in Vestfold or Telemark reads Vestfold og Telemark, in Troms or Finnmark reads Troms og Finnmark. survey_region_name names the region actually used.

Fields

10 of 17 fields are value fields — the ones that decide whether a record actually says anything. The rest are context: identifiers, codes and timestamps. Fields marked “open” return values to anonymous callers; the rest require a key.

FieldTypeRoleDemo
county_codestring | nullcontextopen
survey_region_codestring | nullcontextopen
survey_region_namestring | nullcontextopen
survey_yearinteger | null (årstall)contextopen
kwh_per_household_totalnumber | nullvalueopen
kwh_per_household_electricitynumber | nullvalueopen
kwh_per_household_oilnumber | nullvalueopen
kwh_per_household_woodnumber | nullvalueopen
kwh_per_household_gas_district_heatingnumber | nullvalueopen
electricity_sharenumber | null (andel)valueopen
kwh_per_m2number | null (m2)valueopen
kwh_per_personnumber | nullvalueopen
dwelling_area_m2number | null (m2)valueopen
persons_per_householdnumber | nullvalueopen
norway_kwh_per_household_totalnumber | nullcontextopen
norway_kwh_per_m2number | null (m2)contextopen
updated_atstring | nullcontextopen

Fetch this section

curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643?include=household_energy_baseline"

# paginated, one section at a time
curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643/sections/household_energy_baseline?limit=25"

Try it now

This is a real call against the public demo, from here. What appears below is what the API returned — not a sample.