HOMAI Developers

Partner API · v1

The HOMAI Partner API

Building, roof and site-risk data for every building in Norway in one authenticated request: registry facts, the measured roof plane by plane, satellite image history, climate hazards, zoning, terrain — and HOMAI's roof, facade and insurance assessments.

Base URL
https://your-homai-host/api/v1
Authentication
X-API-Key header
Format
JSON over HTTPS, read-only GET
Coverage
Every building in Norway
On this page

Overview

The Partner API answers one question — what does HOMAI know about this building? — for any address, coordinate, building number or saved property in Norway. A single GET /property returns every data section your key is scoped for:

  • Building data — the registry profile, the measured roof (every roof plane with pitch, facing, areas, eave and ridge heights and its outline) and the years of satellite imagery HOMAI holds.
  • Site data — climate hazards, planning and hazard zones, terrain, and the property at the point.
  • HOMAI analysis — the roof risk score, the roof condition heat map, the facade assessment and the insurance reading, for buildings HOMAI has analysed for you.

The API is read-only and returns JSON. Field names are stable within a version; units are metres, square metres, degrees and WGS84 coordinates unless a field name says otherwise.

Quick start

  1. Get an API key from your HOMAI administrator (see Getting access).
  2. Keep it on your server, for example in an environment variable HOMAI_API_KEY.
  3. Call /property with an address and read the sections you need.
curl -s "https://your-homai-host/api/v1/property?address=Tuengen%20all%C3%A9%2010%2C%200374%20Oslo" \
  -H "X-API-Key: $HOMAI_API_KEY"

Authentication

Every request carries your secret key in the X-API-Key header. A key is homai_ followed by 48 lowercase hexadecimal characters (54 characters in all). Each key has its own scopes, its own per-minute rate limit and, optionally, a set of property categories it may read.

X-API-Key: homai_0123456789abcdef0123456789abcdef0123456789abcdef
Keep keys secret. Call the API from your servers only — never from a browser or a mobile app — and send keys over HTTPS only. The full key is shown once, when it is issued; HOMAI stores only a fingerprint of it. If a key may have leaked, ask for a new one and have the old one revoked.

An api_key query parameter is also accepted for quick manual tests. Do not use it in production: URLs end up in logs and browser histories.

Base URL & versioning

All endpoints live under https://your-homai-host/api/v1 — the HOMAI address you sign in at, followed by /api/v1.

The version is part of the path. Within v1 changes are additive only: new fields, new sections and new scopes may appear, and existing fields keep their names and meaning. Build clients that ignore fields they do not know. A breaking change would come as a new version path, with advance notice.

Rate limits & metering

Each key has a limit of requests per minute, agreed when it is issued (60 by default). The limit applies to a sliding 60-second window.

  • Every /property request counts toward the limit and is metered on your agreement — including requests answered with 400, 403, 404 or 500.
  • /scopes is not counted, but it is refused while the limit is used up.
  • Requests refused with 401 or 429, and calls to unknown paths, are not counted.
  • Each key also has a daily quota of /property requests (5,000 per UTC day unless your agreement says otherwise). Above it the answer is 429 with {"ok": false, "error": "daily_quota_reached"} and a Retry-After until midnight UTC.
Rate-limit response headers
HeaderSent withMeaning
X-RateLimit-Limit/property, /scopes, 429Your key's requests per minute.
X-RateLimit-Remaining/property, /scopes, 429Requests left in the current 60-second window.
Retry-After429Seconds to wait before retrying (also in the body as retry_after_s).

Backing off

async function homai(path, tries = 3) {
  for (let i = 0; i < tries; i++) {
    const res = await fetch(`https://your-homai-host/api/v1${path}`, {
      headers: { "X-API-Key": process.env.HOMAI_API_KEY },
    });
    if (res.status !== 429) return res.json();
    const wait = Number(res.headers.get("Retry-After") ?? 60);
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
  throw new Error("HOMAI rate limit: still limited after retries");
}

Endpoints

Two endpoints, both GET, both authenticated.

Look up a building or location

GET/api/v1/propertyEvery section your key is scoped for

Give one way to locate the building. If you send more than one, HOMAI uses the first in this order: id, lat+lng, building_number, address.

Query parameters of /property
FieldTypeDescription
idintegerId of a saved HOMAI property (the property.id of an earlier answer). Returns its latest analysis too.
lat + lngnumberA point in WGS84 decimal degrees, for example lat=59.93964&lng=10.69808.
building_numberintegerA Norwegian building number (bygningsnummer). Answers for exactly that building.
addressstringA Norwegian address as free text, for example Tuengen allé 10, 0374 Oslo. URL-encode it.
Most answers arrive within a few seconds. A location HOMAI has not computed recently can take longer while its site data is prepared — use a client timeout of at least 60 seconds.

List your scopes

GET/api/v1/scopesWhat the API offers and what your key holds
Fields of the /scopes answer
FieldTypeDescription
okbooleantrue.
versionstringAPI version, v1.
availablestring[]Every scope the API offers.
grantedstring[]The scopes your key holds.
descriptionsobjectScope → one-line description.
rate_limit_per_minintegerYour key's requests per minute.
curl -s "https://your-homai-host/api/v1/scopes" -H "X-API-Key: $HOMAI_API_KEY"
Example answer
{
  "ok": true,
  "version": "v1",
  "available": [
    "property_basic",
    "building",
    "roof_geometry",
    "imagery",
    "eiendom",
    "climate_hazards",
    "plan_zoning",
    "terrain",
    "roof_analysis",
    "roof_heatmap",
    "facade",
    "insurance",
    "maintenance",
    "energy",
    "market",
    "trees",
    "area",
    "risk_score",
    "climate_future",
    "contractors",
    "images"
  ],
  "granted": ["property_basic", "building", "roof_geometry", "imagery", "climate_hazards"],
  "descriptions": {
    "property_basic": "Location, saved property id, label and category",
    "building": "Building profile: registry facts, address and parcel identifiers",
    "roof_geometry": "Measured roof: every roof plane with pitch, facing, areas, heights and outline",
    "imagery": "Satellite image history: the years HOMAI holds for the building",
    "eiendom": "Address, cadastre (matrikkel) and property details at the point",
    "climate_hazards": "Climate hazard scores: precipitation, landslide, flooding, storm, quick clay, snow avalanche & rockfall, storm surge & sea level, radon",
    "plan_zoning": "Planning, hazard and consideration zones at the point",
    "terrain": "Terrain: ground height, slope, building height, runoff",
    "roof_analysis": "HOMAI roof risk score, condition and roof facts",
    "roof_heatmap": "Roof condition heat map: graded grid cells, planes and hotspots",
    "facade": "Street-level facade assessment",
    "insurance": "Insurance assessment and underwriting notes",
    "images": "First-party image references saved on the property"
  },
  "rate_limit_per_min": 60
}

How a location is matched

Building data

building, roof_geometry and imagery describe one building: the one whose measured roof is under your point; else the building registered at the nearest address; else the closest building within about 40 m. With building_number it is exactly that building. building.match tells you which rule found it.

Site data

eiendom, climate, plan and terrainare computed for the point. When a saved property is matched, they are computed for that property's point.

HOMAI analysis

roof, roof_heatmap, facade, insurance, maintenance, energy, market, trees, area, risk_score, climate_future, contractors and images come from the latest analysis of the saved property given by id, or found within about 100 m of the location. property.id and roof.building_number show which one. Use id when you need an exact match.

When there is no data

A granted section with nothing to show is left out of the answer and listed in unavailable. When no saved analysis matches, the analysis sections are left out and note says so. The request still succeeds.

Scopes

Every section needs its own scope. A key returns only the sections it was granted; ask your HOMAI administrator to add scopes to your key.

Scopes and the response sections they unlock
ScopeResponse keyReturnsKind
property_basicpropertyLocation & saved propertyLocation
buildingbuildingBuilding profileBuilding data
roof_geometryroof_geometryMeasured roof geometryBuilding data
imageryimagerySatellite image historyBuilding data
eiendomeiendomProperty at the pointSite data at the point
climate_hazardsclimateClimate hazardsSite data at the point
plan_zoningplanPlanning & hazard zonesSite data at the point
terrainterrainTerrainSite data at the point
roof_analysisroofRoof risk assessmentHOMAI analysis
roof_heatmaproof_heatmapRoof condition heat mapHOMAI analysis
facadefacadeFacade assessmentHOMAI analysis
insuranceinsuranceInsurance assessmentHOMAI analysis
maintenancemaintenanceMaintenance planHOMAI analysis
energyenergyEnergy & solarHOMAI analysis
marketmarketHOMAI market dataHOMAI analysis
treestreesTreesHOMAI analysis
areaareaAreaHOMAI analysis
risk_scorerisk_scoreHOMAI risk scoreHOMAI analysis
climate_futureclimate_futureFuture climateHOMAI analysis
contractorscontractorsContractorsHOMAI analysis
imagesimagesImage referencesHOMAI analysis

Response envelope

A successful /property answer is a JSON object with HTTP status 200:

Top-level fields of a /property answer
FieldTypeDescription
okbooleantrue for every successful answer.
pointobjectlat, lng — the point the answer is for.
<section>objectOne key per granted scope that has data here (see Scopes).
unavailablestring[]Granted scopes with no data at this location. Never contains a scope you were not granted.
notestringPresent when analysis scopes are granted but no saved HOMAI analysis matches the location.
images_notestringPresent with the images section.
attributionstringAlways © HOMAI.
creditsstring[]Present when an answer includes open data whose licence requires attribution (eiendom, climate_hazards, plan_zoning, terrain, area, climate_future). The climate line names only the open-data owners whose data is in that answer (NVE, NIBIO, MET Norway, Kartverket, NGU). Show these lines wherever you display that data.

Unknown values are null. Timestamps are ISO 8601 in UTC. Coordinates are WGS84; outlines and bounding boxes list longitude before latitude, as in GeoJSON.

Sections

What each scope adds to the answer. Expand Example under a section to see it as it appears in a response.

Location & saved property

scopeproperty_basic→ keypropertyLocation

The resolved point and, when there is one, the saved HOMAI property it matched.

Fields of the property section
FieldTypeDescription
idinteger | nullId of the saved HOMAI property that was matched, or null. Use it as the id parameter later.
labelstring | nullLabel of the saved property.
categorystring | nullCategory of the saved property.
latnumberLatitude of the resolved point (WGS84).
lngnumberLongitude of the resolved point (WGS84).
Example
{
  "property": {
    "id": 1042,
    "label": "Tuengen allé 10, 0374 Oslo",
    "category": "Residential",
    "lat": 59.9396431,
    "lng": 10.6980801
  }
}

Building profile

scopebuilding→ keybuildingBuilding data

Registry facts for the building at the location, its address and parcel identifiers, and the other buildings on the same parcel.

Fields of the building section
FieldTypeDescription
building_numberintegerNorwegian building number (bygningsnummer).
matchstringHow the building was found: roof_at_point, address, nearest_building or building_number.
typestring | nullRegistered building type, in Norwegian (for example Enebolig).
type_codestring | nullRegistered building type code.
statusstring | nullRegistered building status (for example Ferdigattest).
status_datestring | nullDate of the registered status, YYYY-MM-DD.
business_groupstring | nullRegistered business group.
estimated_build_yearinteger | nullEstimated year of construction.
estimated_build_datestring | nullEstimated date of construction, YYYY-MM-DD.
floors_registeredinteger | nullNumber of floors in the register.
floors_estimatedinteger | nullEstimated number of floors from the building's measured height.
dwelling_unitsinteger | nullNumber of dwelling units.
usable_area_m2number | nullUsable floor area (BRA), m².
gross_area_m2number | nullGross floor area (BTA), m².
wall_area_m2number | nullTotal external wall area, m².
wall_height_max_mnumber | nullHighest wall height, m.
wall_height_mean_mnumber | nullMean wall height, m.
verandasinteger | nullNumber of verandas.
veranda_area_m2number | nullTotal veranda area, m².
roof_type_registeredstring | nullRegistered roof type, in Norwegian (Saltak, Valmet tak, Flatt tak, Skråtak, Annet).
roof_type_registered_labelstring | nullThe registered roof type in English (Gable, Hipped, Flat, Mono-pitch (shed), Other / composite).
flat_roof_registeredboolean | nullWhether the building is registered with a flat roof.
roof_area_2d_m2number | nullRegistered roof footprint area, m².
roof_area_3d_m2number | nullRegistered roof surface area, m².
roof_pitch_mean_degnumber | nullRegistered mean roof pitch, degrees.
roof_pitch_max_degnumber | nullRegistered maximum roof pitch, degrees.
heritage.cultural_heritageboolean | nullThe building is registered as a cultural-heritage site.
heritage.sefrakboolean | nullThe building is in the SEFRAK register of older buildings.
registered_hazardsobject | nullRegistered site hazards when available: flood, quick_clay, rockfall, snow_avalanche, power_line, coast_100m, protected_building, fire_station_km.
addressobject | nulltext, street, house_number, letter, postal_code, postal_place, municipality, municipality_number, county, address_id, lat, lng.
parcelobject | nullCadastre (matrikkel) identifiers: unit_id, municipality_number, gnr, bnr, fnr, snr, label (for example 0301-36/148).
other_buildings_on_parcel[]arrayOther buildings on the same parcel: building_number, type, status, roof_area_2d_m2, roof_type_registered, estimated_build_year.
locationobject | nulllat, lng of the building (the centre of its measured roof when there is one).
as_ofstring | nullWhen HOMAI last refreshed this building's record (ISO 8601).
Example
{
  "building": {
    "building_number": 80107137,
    "match": "building_number",
    "type": "Enebolig",
    "type_code": "111",
    "status": "Ferdigattest",
    "status_date": null,
    "business_group": "Annet som ikke er næring",
    "estimated_build_year": 1934,
    "estimated_build_date": "1934-03-08",
    "floors_registered": 2,
    "floors_estimated": 3,
    "dwelling_units": 1,
    "usable_area_m2": 254,
    "gross_area_m2": 381,
    "wall_area_m2": 368,
    "wall_height_max_m": 7.48,
    "wall_height_mean_m": 5.73,
    "verandas": 0,
    "veranda_area_m2": 0,
    "roof_type_registered": "Saltak",
    "roof_type_registered_label": "Gable",
    "flat_roof_registered": false,
    "roof_area_2d_m2": 168,
    "roof_area_3d_m2": 177,
    "roof_pitch_mean_deg": 15.3,
    "roof_pitch_max_deg": 19.8,
    "heritage": {
      "cultural_heritage": false,
      "sefrak": false
    },
    "registered_hazards": null,
    "address": {
      "text": "Tuengen allé 10, Oslo",
      "street": "Tuengen allé",
      "house_number": 10,
      "letter": null,
      "postal_code": "0374",
      "postal_place": "Oslo",
      "municipality": "Oslo",
      "municipality_number": "0301",
      "county": "Oslo",
      "address_id": "03011780200100000000",
      "lat": 59.9396849,
      "lng": 10.6980191
    },
    "parcel": {
      "unit_id": "03010003601480000000",
      "municipality_number": "0301",
      "gnr": 36,
      "bnr": 148,
      "fnr": 0,
      "snr": 0,
      "label": "0301-36/148"
    },
    "other_buildings_on_parcel": [],
    "location": {
      "lat": 59.9396431,
      "lng": 10.6980801
    },
    "as_of": "2026-09-14T15:50:06+00:00"
  }
}

Measured roof geometry

scoperoof_geometry→ keyroof_geometryBuilding data

The roof as measured: every roof plane with its pitch, facing, areas, heights and outline, plus a summary of the whole roof. Heights are above ground unless the name says elevation (above sea level).

Fields of the roof_geometry section
FieldTypeDescription
building_numberinteger | nullThe building the roof belongs to.
summary.roof_classstringRoof class: flat, shed, gable, hip or complex.
summary.roof_type_labelstring | nullRoof type in plain English.
summary.measured_classstringThe class the measured planes alone point to.
summary.roof_type_registeredstring | nullThe registered roof type, for comparison.
summary.plane_countintegerNumber of roof planes.
summary.significant_plane_countintegerPlanes of 2 m² or more.
summary.sloped_plane_countintegerSignificant planes with a pitch of 6° or more.
summary.flat_plane_countintegerPlanes under 6° (flat / low-slope).
summary.area_3d_m2numberRoof surface area, m².
summary.area_2d_m2numberRoof footprint area, m².
summary.slope_factornumber | nullSurface area ÷ footprint area.
summary.pitch_dominant_degnumber | nullDominant roof pitch, degrees (area-weighted).
summary.pitch_sloped_mean_degnumber | nullMean pitch of the sloped planes, degrees.
summary.pitch_min_deg / pitch_max_degnumber | nullLowest sloped and highest plane pitch, degrees.
summary.pitch_classstringflat (< 6°), low (< 15°), medium (< 28°) or steep.
summary.flat_area_m2numberArea of the flat / low-slope planes, m².
summary.flat_rationumberShare of the roof surface that is flat, 0–1.
summary.orientation_countintegerNumber of distinct facing directions of the sloped roof.
summary.orientations[]arrayPer facing direction: facing, aspect_deg, area_m2, planes.
summary.sector_area_m2objectSloped roof area per compass sector: N, NE, E, SE, S, SW, W, NW (m²).
summary.north_facing_ratio / south_facing_rationumber | nullShare of the sloped roof facing north / south (within 45°).
summary.dominant_facingstring | nullFacing of the largest roof direction (16-point compass).
summary.eave_height_min_m / eave_height_max_mnumber | nullLowest and highest eave height, m.
summary.eave_height_main_mnumber | nullEave height of the largest sloped plane, m.
summary.ridge_height_mnumber | nullHeight of the roof's highest point, m.
summary.solar_suitable_area_m2numberRoof area suited to solar panels, m².
summary.solar_suitable_planesintegerNumber of planes suited to solar panels.
summary.solar_irradiance_kwh_m2_yearnumber | nullMean yearly solar irradiance on the roof, kWh/m², when known.
summary.bboxnumber[4][min_lng, min_lat, max_lng, max_lat] of the roof.
summary.centernumber[2][lng, lat] of the roof centre.
planes[].idstringPlane id, stable for the building.
planes[].pitch_degnumber | nullPitch, degrees.
planes[].aspect_degnumber | nullFacing, degrees clockwise from true north (null for flat planes).
planes[].facingstring16-point compass facing (N, NNE … NNW) or flat.
planes[].area_3d_m2numberPlane surface area, m².
planes[].area_2d_m2numberPlane footprint area, m².
planes[].length_m / width_mnumber | nullPlane length (eave to top) and width, m.
planes[].eave_height_mnumber | nullEave height, m.
planes[].top_height_mnumber | nullHeight of the plane's top, m.
planes[].top_elevation_mnumber | nullElevation of the plane's top, m above sea level.
planes[].solar_kwh_m2_yearnumber | nullYearly solar irradiance on the plane, kWh/m², when known.
planes[].outlinenumber[][]Closed outline of the plane as [lng, lat] pairs (WGS84).
as_ofstring | nullWhen HOMAI last refreshed this roof (ISO 8601).
Example
{
  "roof_geometry": {
    "building_number": 80107137,
    "summary": {
      "roof_class": "gable",
      "roof_type_label": "Gable",
      "measured_class": "hip",
      "roof_type_registered": "Saltak",
      "plane_count": 7,
      "significant_plane_count": 7,
      "sloped_plane_count": 6,
      "flat_plane_count": 1,
      "area_3d_m2": 177.3,
      "area_2d_m2": 168.7,
      "slope_factor": 1.051,
      "pitch_dominant_deg": 18.6,
      "pitch_sloped_mean_deg": 18.6,
      "pitch_min_deg": 18.3,
      "pitch_max_deg": 19.8,
      "pitch_class": "medium",
      "flat_area_m2": 13.4,
      "flat_ratio": 0.075,
      "orientation_count": 4,
      "orientations": [
        {
          "facing": "SSW",
          "aspect_deg": 207,
          "area_m2": 50.6,
          "planes": 1
        },
        {
          "facing": "NNE",
          "aspect_deg": 27,
          "area_m2": 50,
          "planes": 2
        },
        {
          "facing": "ESE",
          "aspect_deg": 117,
          "area_m2": 32,
          "planes": 1
        },
        {
          "facing": "WNW",
          "aspect_deg": 297,
          "area_m2": 31.3,
          "planes": 2
        }
      ],
      "sector_area_m2": {
        "N": 0,
        "NE": 50,
        "E": 0,
        "SE": 32,
        "S": 0,
        "SW": 50.6,
        "W": 0,
        "NW": 31.3
      },
      "north_facing_ratio": 0.305,
      "south_facing_ratio": 0.309,
      "dominant_facing": "SSW",
      "eave_height_min_m": 5.3,
      "eave_height_max_m": 7.2,
      "eave_height_main_m": 7,
      "ridge_height_m": 8.6,
      "solar_suitable_area_m2": 82.6,
      "solar_suitable_planes": 2,
      "solar_irradiance_kwh_m2_year": null,
      "bbox": [10.6979151, 59.9395687, 10.6982452, 59.9397175],
      "center": [10.6980801, 59.9396431]
    },
    "planes": [
      {
        "id": "930110162811",
        "pitch_deg": 18.3,
        "aspect_deg": 207,
        "facing": "SSW",
        "area_3d_m2": 50.6,
        "area_2d_m2": 48,
        "length_m": 5.25,
        "width_m": 14.53,
        "eave_height_m": 7,
        "top_height_m": 8.6,
        "top_elevation_m": 89.6,
        "solar_kwh_m2_year": null,
        "outline": [
          [10.6981096, 59.9396387],
          [10.698146, 59.9395789],
          [10.6979151, 59.9396387],
          [10.6980322, 59.9396582],
          [10.6981096, 59.9396387]
        ]
      },
      {
        "id": "930110162816",
        "pitch_deg": 18.4,
        "aspect_deg": 27,
        "facing": "NNE",
        "area_3d_m2": 41.1,
        "area_2d_m2": 39,
        "length_m": 5.23,
        "width_m": 11.57,
        "eave_height_m": 7,
        "top_height_m": 8.6,
        "top_elevation_m": 89.6,
        "solar_kwh_m2_year": null,
        "outline": [
          [10.6981572, 59.9396476],
          [10.6981096, 59.9396387],
          [10.6980322, 59.9396582],
          [10.6979959, 59.9397175],
          [10.6981331, 59.939682],
          [10.6981572, 59.9396476]
        ]
      }
    ],
    "as_of": "2026-09-14T15:50:06+00:00"
  }
}

Satellite image history

scopeimagery→ keyimageryBuilding data

Which years HOMAI holds a satellite image of the building — the basis of its change-over-time and age analysis. Metadata only: the images themselves are not returned.

Fields of the imagery section
FieldTypeDescription
yearsinteger[]Every year with a colour satellite image of the building, oldest first.
year_countintegerNumber of years.
first_year / latest_yearinteger | nullOldest and newest year.
capture_countinteger | nullNumber of image captures covering the building, infrared included.
currentobject | nullThe newest image: year, season, ground_resolution_m.
infrared_yearinteger | nullYear of the newest colour-infrared image (shows vegetation such as moss).
history[]arrayOne entry per year: year, season (spring, summer, autumn, winter or null), ground_resolution_m.
Example
{
  "imagery": {
    "years": [1937, 1947, 1956, 1971, 1984, 1997, 2004, 2010, 2016, 2020, 2022, 2024, 2025, 2026],
    "year_count": 14,
    "first_year": 1937,
    "latest_year": 2026,
    "capture_count": 48,
    "current": {
      "year": 2026,
      "season": "spring",
      "ground_resolution_m": 0.08
    },
    "infrared_year": 2025,
    "history": [
      {
        "year": 1937,
        "season": null,
        "ground_resolution_m": null
      },
      {
        "year": 1947,
        "season": null,
        "ground_resolution_m": null
      },
      {
        "year": 2026,
        "season": "spring",
        "ground_resolution_m": 0.08
      }
    ]
  }
}

Property at the point

scopeeiendom→ keyeiendomSite data at the point

The nearest address, cadastre (matrikkel) unit and property details at the point, with ground elevation, nearby place names and current weather.

Fields of the eiendom section
FieldTypeDescription
okbooleantrue when the lookup ran.
lat / lngnumberThe point.
elevationnumber | nullGround elevation, m above sea level.
addressobject | nulllabel, street, number, letter, postal_code, postal_place, municipality, municipality_nr, lat, lng.
matrikkelobject | nullkommunenummer, gardsnummer, bruksnummer, festenummer, seksjonsnummer, display.
eiendomobject | nullland_area (m²), units, buildings[] (number, type, status, build_year, gross_area, floors).
places[]arrayNearby place names: name, type, distance.
weatherobject | nullcurrent: temperature_2m, apparent_temperature, relative_humidity_2m, precipitation, weather_code, wind_speed_10m, wind_gusts_10m; timezone.
Example
{
  "eiendom": {
    "ok": true,
    "lat": 59.9396431,
    "lng": 10.6980801,
    "elevation": 81.1,
    "address": {
      "label": "Tuengen allé 10",
      "street": "Tuengen allé",
      "number": "10",
      "letter": "",
      "postal_code": "0374",
      "postal_place": "OSLO",
      "municipality": "OSLO",
      "municipality_nr": "0301",
      "lat": 59.9396849,
      "lng": 10.6980191
    },
    "matrikkel": {
      "kommunenummer": "0301",
      "gardsnummer": "36",
      "bruksnummer": "148",
      "festenummer": "0",
      "seksjonsnummer": "0",
      "display": "0301-36/148"
    },
    "eiendom": {
      "land_area": 812,
      "units": 1,
      "buildings": [
        {
          "number": 80107137,
          "type": "Enebolig",
          "status": "Ferdigattest",
          "build_year": 1934,
          "gross_area": 254,
          "floors": 2
        }
      ]
    },
    "places": [
      {
        "name": "Vinderen",
        "type": "Bydel",
        "distance": null
      }
    ],
    "weather": {
      "current": {
        "temperature_2m": 6.3,
        "apparent_temperature": 2.8,
        "relative_humidity_2m": 69,
        "precipitation": 0,
        "weather_code": 3,
        "wind_speed_10m": 3,
        "wind_gusts_10m": 5.5
      },
      "timezone": "GMT+2"
    }
  }
}

Climate hazards

scopeclimate_hazards→ keyclimateSite data at the point

Exposure to eight damage hazards — extreme precipitation, landslide, flooding and storm everywhere, plus quick clay, snow avalanche & rockfall, storm surge & sea level and radon where the property lies in a mapped zone — combined into one climate score, plus an informational biodiversity reading. Texts come in Norwegian (no) and English (en); show the English text.

Fields of the climate section
FieldTypeDescription
okbooleantrue when the assessment ran.
climate_score.valuenumberClimate score, 0–10 (higher = more exposed).
climate_score.maxnumberAlways 10.
climate_score.levelstringLow, Medium or High.
climate_score.weightsobjectWeight of each hazard in the score. The four core hazards sum to 1; quick_clay, avalanche_rockfall, storm_surge and radon are on the same scale.
climate_score.breakdown[]arrayPer hazard: key, label, band (1–5), weight, contribution. Location hazards also carry location_hazard: true and counted: they count only inside a mapped zone rated Medium or above, and only when they raise the score (contribution null otherwise).
hazards[].keystringprecipitation, landslide, flooding, storm, quick_clay, avalanche_rockfall, storm_surge or radon.
hazards[].nameobjectHazard name: no, en.
hazards[].levelstring | nullLow, Medium or High.
hazards[].exposureobject | nullkey, no, en, band (1 = very low … 5 = very high) and the full scale[].
hazards[].ratingstringmeasured (from mapped data at the point), estimated (regional estimate), uncertain (radon class uncertain) or unknown (not assessed: the data did not answer).
hazards[].zoneobjectquick_clay: name, hazard_degree (high, medium, low, none), risk_class (1–5), part (release or run_out). avalanche_rockfall: return_period_years (100, 1000 or 5000) and types.
hazards[].water_levels_cm / sea_level / ground_mobjectstorm_surge only: surge water levels in cm above sea level (20/200/1000-year today, 200/1000-year and high-end 2100; null where the flood area does not reach the point), projected sea-level rise by 2100 (rise_cm, range_cm, scenario) and ground height in m.
hazards[].radon_classstringradon only: low, medium, high, very_high or uncertain.
hazards[].rationale / whyobjectWhy this level here, and why the hazard matters: no, en.
hazards[].consequences[] / measures[]arrayTypical consequences and mitigating measures: no, en.
hazards[].iconstringIcon hint for display: rain, mountain, waves, wind, layers, snowflake or radiation.
climate_score.sample / hazards[].samplebooleantrue while a value is a placeholder rather than an assessment of this location.
biodiversityobjectInformational only, never part of the score: sensitivity, forest, species (red-list counts by category within radius_km), rationale.
land_coverobject | nullLand-cover class at the point: artype, no, en.
generated_atstringWhen the assessment was made (ISO 8601).
Example
{
  "climate": {
    "ok": true,
    "climate_score": {
      "value": 3.5,
      "max": 10,
      "level": "Low",
      "sample": false,
      "weights": {
        "precipitation": 0.25,
        "landslide": 0.25,
        "flooding": 0.25,
        "storm": 0.25,
        "quick_clay": 0.35,
        "avalanche_rockfall": 0.25,
        "storm_surge": 0.3,
        "radon": 0.05
      },
      "breakdown": [
        {
          "key": "precipitation",
          "label": "Extreme Precipitation",
          "band": 3,
          "weight": 0.25,
          "contribution": 1.5
        },
        {
          "key": "landslide",
          "label": "Landslide",
          "band": 1,
          "weight": 0.25,
          "contribution": 0.5
        },
        {
          "key": "flooding",
          "label": "Flooding",
          "band": 1,
          "weight": 0.25,
          "contribution": 0.5
        },
        {
          "key": "storm",
          "label": "Storm",
          "band": 2,
          "weight": 0.25,
          "contribution": 1
        },
        {
          "key": "quick_clay",
          "label": "Quick clay",
          "band": 1,
          "weight": 0.35,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        },
        {
          "key": "avalanche_rockfall",
          "label": "Snow avalanche & rockfall",
          "band": 1,
          "weight": 0.25,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        },
        {
          "key": "storm_surge",
          "label": "Storm surge & sea level",
          "band": 1,
          "weight": 0.3,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        },
        {
          "key": "radon",
          "label": "Radon",
          "band": 2,
          "weight": 0.05,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        }
      ]
    },
    "hazards": [
      {
        "key": "landslide",
        "name": {
          "no": "Jordskred",
          "en": "Landslide"
        },
        "icon": "mountain",
        "level": "Low",
        "exposure": {
          "key": "svaert_lav",
          "no": "Svært lav",
          "en": "Very low",
          "band": 1,
          "scale": [
            {
              "key": "svaert_lav",
              "no": "Svært lav",
              "en": "Very low",
              "band": 1
            }
          ]
        },
        "rationale": {
          "no": "Området ligger utenfor kartlagte aktsomhetssoner for jord- og flomskred.",
          "en": "The area is outside mapped landslide susceptibility zones."
        },
        "why": {
          "no": "Helning og grunnforhold indikerer potensial for ustabile masser.",
          "en": "Slope and soil conditions indicate a moderate potential for slope instability."
        },
        "consequences": [
          {
            "no": "Skader på yttervegg og knuste vinduer.",
            "en": "Damage to exterior walls and broken windows."
          }
        ],
        "measures": [
          {
            "no": "Installere fysiske barrierer for å avlede nedfall.",
            "en": "Install physical barriers to divert debris."
          }
        ],
        "sample": false,
        "rating": "measured"
      }
    ],
    "biodiversity": {
      "key": "biodiversity",
      "informational": true,
      "sensitivity": {
        "key": "moderat",
        "no": "Moderat",
        "en": "Moderate",
        "band": 3
      },
      "forest": {
        "is_forest": false,
        "type": null,
        "bonitet": null,
        "no": "Bebygd og samferdsel",
        "en": "Built-up / transport"
      },
      "species": {
        "count_distinct": 51,
        "nearest_m": 524,
        "by_category": {
          "NT": 30,
          "VU": 12,
          "EN": 7,
          "CR": 2
        },
        "radius_km": 2,
        "note": "recorded nearby",
        "status": "ok"
      }
    },
    "land_cover": {
      "artype": 10,
      "no": "Bebygd og samferdsel",
      "en": "Built-up / transport"
    },
    "generated_at": "2026-10-09T21:20:23+00:00"
  }
}

Planning & hazard zones

scopeplan_zoning→ keyplanSite data at the point

Zoning plans, land-use purposes, hazard zones, consideration zones and restriction zones that cover the point.

Fields of the plan section
FieldTypeDescription
okbooleantrue when at least one zone covers the point.
zones[].layerstringZone kind: RpOmrade, RpArealformålOmrade, RpHensynSoneOmrade, RpFareSoneOmrade or RpBåndleggingSoneOmrade.
zones[].fieldsobjectThe zone's registered attributes (plan id, name, purpose, zone type …), as registered.
generated_atstringWhen the lookup was made (ISO 8601).
Example
{
  "plan": {
    "ok": true,
    "zones": [
      {
        "layer": "RpArealformålOmrade",
        "fields": {
          "planidentifikasjon": "S-4129",
          "arealformål": "Boligbebyggelse"
        }
      }
    ],
    "generated_at": "2026-10-09T21:20:30+00:00"
  }
}

Terrain

scopeterrain→ keyterrainSite data at the point

Ground height, slope and relative height at the point, the building's height above ground, and what that means for surface-water runoff.

Fields of the terrain section
FieldTypeDescription
okbooleanfalse when the terrain could not be read; reason says why.
ground_elev_mnumber | nullGround elevation, m above sea level.
surface_elev_mnumber | nullSurface elevation (top of building or vegetation), m above sea level.
building_height_mnumber | nullSurface minus ground, m.
terrain_slope_degnumber | nullTerrain slope, degrees.
aspectstring | nullDownslope direction: N, NE, E, SE, S, SW, W or NW.
relative_height_mnumber | nullHeight above the lowest surrounding ground within about 12 m.
flood_runoff_notestringPlain-English runoff reading.
generated_atstringWhen the reading was made (ISO 8601).
Example
{
  "terrain": {
    "ok": true,
    "ground_elev_m": 81,
    "surface_elev_m": 89.6,
    "building_height_m": 8.6,
    "terrain_slope_deg": 3.4,
    "aspect": "SW",
    "relative_height_m": 1.1,
    "flood_runoff_note": "Moderate terrain drainage.",
    "generated_at": "2026-10-09T21:20:36+00:00"
  }
}

Roof risk assessment

scoperoof_analysis→ keyroofHOMAI analysis

HOMAI's roof assessment: a 0–100 risk score with its factor breakdown, the roof's condition and the roof facts it rests on.

Fields of the roof section
FieldTypeDescription
risk_scoreintegerRoof risk index, 0–100 (higher = riskier).
risk_levelstringLow, Medium or High.
roof_assessedbooleanWhether the roof itself could be assessed from imagery.
factsobject | nullRoof facts: type, plane_count, pitch_degrees, pitch_class, material, condition, defects[], flat_section_ratio, penetrations (chimneys, roof_windows, vents), drainage_visible, confidence.
risk_breakdownobject | nullrisk_index, breakdown (per factor: label, score, weight, contribution), weighted_sum, confidence_drag, confidence, factor_count.
overall_conditionstring | nullGood, Fair, Poor …
main_riskstring | nullThe main risk driver in one line.
confidencenumber | nullConfidence of the assessment, 0–1.
remaining_lifespanstring | nullExpected remaining life of the roof covering, with its basis.
inspection_intervalstring | nullRecommended inspection interval.
summarystring | nullPlain-English summary.
recommendations[]string[]Recommended actions.
building_numberinteger | nullThe building the analysis covers.
analysed_atstring | nullWhen the analysis was made (ISO 8601).
Example
{
  "roof": {
    "risk_score": 41,
    "risk_level": "Medium",
    "roof_assessed": true,
    "facts": {
      "type": "gable",
      "plane_count": 7,
      "pitch_degrees": 18.6,
      "pitch_class": "medium",
      "material": "tile",
      "condition": "fair",
      "defects": ["moss", "wear"],
      "flat_section_ratio": 0.08,
      "penetrations": {
        "chimneys": 1,
        "roof_windows": 2,
        "vents": 2,
        "confidence": 0.6
      },
      "drainage_visible": "adequate",
      "confidence": 0.8
    },
    "risk_breakdown": {
      "risk_index": 41,
      "breakdown": {
        "age": {
          "label": "Roof Age",
          "score": 58,
          "weight": 0.2315,
          "contribution": 13.43
        },
        "visible_defects": {
          "label": "Visible Defects",
          "score": 44,
          "weight": 0.1389,
          "contribution": 6.11
        }
      },
      "weighted_sum": 40.2,
      "confidence_drag": 0.8,
      "confidence": 0.84,
      "factor_count": 10
    },
    "overall_condition": "Fair",
    "main_risk": "Moss and wear on the north-facing tiled slopes",
    "confidence": 0.8,
    "remaining_lifespan": "10–20 years with maintenance",
    "inspection_interval": "2 years",
    "summary": "A 1934 detached house with a tiled gable roof of about 177 m² at an 18.6° pitch. The covering is in fair condition with moss on the shaded slopes.",
    "recommendations": ["Remove moss from the north-facing slopes", "Check flashings around the chimney"],
    "building_number": 80107137,
    "analysed_at": "2026-10-02T09:12:40+00:00"
  }
}

Roof condition heat map

scoperoof_heatmap→ keyroof_heatmapHOMAI analysis

A grid laid over the measured roof, graded cell by cell from the newest satellite image and compared with an older year: where the covering is sound, worn, damaged or repaired — per cell, per roof plane and for the whole roof.

Fields of the roof_heatmap section
FieldTypeDescription
condition_indexinteger | nullRoof condition, 0–100 (100 = sound).
condition_bandstring | nullgood (91–100), fair (71–90), worn (51–70) or poor (≤ 50).
coveringstring | nullRoof covering seen: tile, concrete_tile, slate, metal, bitumen_shingle, membrane, green or unknown.
image_qualitystring | nullgood, fair or poor.
roof_surface_m2number | nullRoof surface graded, m².
affected_m2 / defect_m2 / repaired_m2number | nullArea showing wear or worse, area with a moderate or serious defect, and area repaired, m².
unassessable_sharenumber | nullShare of the roof hidden (shadow, trees, snow), 0–1.
state_countsobjectNumber of cells per state.
hotspots[]arrayThe worst cells: cell, plane, state, severity, confidence, change, note.
planes[]arrayPer roof plane: plane, facing, pitch_deg, area_m2, condition_index, condition_band, worst_state, affected_share, cells.
gridobject | nullcolumns, rows, cell_size_m. Cells are named column letter + row number (A1 is top-left, north up).
cells[]arrayEvery cell: cell, column, row, plane, state, severity (0–3), confidence (0–1), change, repair, heat (0–1), area_m2, note.
cells[].statestringok, damage, ponding, rust, moss, debris, wear, lichen, patch, renewed, obstructed or not_roof.
cells[].changestringAgainst the older image: new, persisting, resolved or unknown.
image_year / compared_with_yearinteger | nullYear of the graded image and of the image it was compared with.
summary / limitationsstring | nullPlain-English reading and what limits it.
generated_atstring | nullWhen the heat map was made (ISO 8601).
Example
{
  "roof_heatmap": {
    "condition_index": 84,
    "condition_band": "fair",
    "covering": "tile",
    "image_quality": "good",
    "roof_surface_m2": 176.2,
    "affected_m2": 9.6,
    "defect_m2": 0,
    "repaired_m2": 3.1,
    "unassessable_share": 0.04,
    "state_counts": {
      "ok": 18,
      "moss": 3,
      "wear": 2,
      "patch": 1,
      "obstructed": 1
    },
    "hotspots": [
      {
        "cell": "C2",
        "plane": 2,
        "state": "moss",
        "severity": 1,
        "confidence": 0.7,
        "change": "persisting",
        "note": "Moss along the lower courses"
      }
    ],
    "planes": [
      {
        "plane": 2,
        "facing": "NNE",
        "pitch_deg": 18.4,
        "area_m2": 41.1,
        "condition_index": 80,
        "condition_band": "fair",
        "worst_state": "moss",
        "affected_share": 0.21,
        "cells": 7
      }
    ],
    "grid": {
      "columns": 6,
      "rows": 5,
      "cell_size_m": 2.9
    },
    "cells": [
      {
        "cell": "C2",
        "column": 2,
        "row": 1,
        "plane": 2,
        "state": "moss",
        "severity": 1,
        "confidence": 0.7,
        "change": "persisting",
        "repair": false,
        "heat": 0.29,
        "area_m2": 7.9,
        "note": "Moss along the lower courses"
      },
      {
        "cell": "D4",
        "column": 3,
        "row": 3,
        "plane": 1,
        "state": "ok",
        "severity": 0,
        "confidence": 1,
        "change": "unknown",
        "repair": false,
        "heat": 0,
        "area_m2": 8.4,
        "note": null
      }
    ],
    "image_year": 2026,
    "compared_with_year": 2019,
    "summary": "The tiled roof is largely sound; moss sits along the lower courses of the north-facing slope and one small patch repair shows near the chimney.",
    "limitations": "Tree shadow on the west side limits certainty on two cells.",
    "generated_at": "2026-10-02T09:11:58+00:00"
  }
}

Facade assessment

scopefacade→ keyfacadeHOMAI analysis

The building seen from the street: materials, condition, defects, remaining life per element and the maintenance that follows. Text and grades only — the street-level photos are not returned.

Fields of the facade section
FieldTypeDescription
headlinestring | nullOne sentence on the facade's state.
target_visibleboolean | nullWhether the building could be seen from the street.
conditionobject | nullgrade (good, fair, worn, poor or unknown), index (0–100, 100 = as new), summary.
facadeobject | nullstoreys_visible, materials[], colour, style_era, windows, balconies, entrances.
findings[]arrayelement, issue, severity (1–3), confidence (0–1), view.
remaining_life[]arrayelement, years_low, years_high, basis.
maintenance[]arraywhen (now, within_1y, within_3y, within_5y or monitor), action, why.
views[]arrayEach street-level view used: index, captured (YYYY-MM), heading_deg, distance_m, shows_target, side, quality, note.
kpis[]arrayHeadline figures: key, label, value, unit, status, basis.
limitationsstring | nullWhat limits the assessment.
generated_atstring | nullWhen the assessment was made (ISO 8601).
Example
{
  "facade": {
    "headline": "Painted timber facade in fair order, with weathered paint on the south-west side.",
    "target_visible": true,
    "condition": {
      "grade": "fair",
      "index": 68,
      "summary": "Timber cladding is intact; paint is weathered on the sunny side and window sills need attention."
    },
    "facade": {
      "storeys_visible": 2,
      "materials": ["timber cladding"],
      "colour": "white",
      "style_era": "1930s detached house",
      "windows": "Painted timber frames",
      "balconies": "None visible",
      "entrances": "Front door with a small porch"
    },
    "findings": [
      {
        "element": "Paint (south-west wall)",
        "issue": "Weathered and flaking paint",
        "severity": 2,
        "confidence": 0.6,
        "view": 1
      }
    ],
    "remaining_life": [
      {
        "element": "Timber cladding",
        "years_low": 15,
        "years_high": 30,
        "basis": "Sound boards; repaint every 8–12 years"
      }
    ],
    "maintenance": [
      {
        "when": "within_1y",
        "action": "Repaint the south-west wall",
        "why": "Bare timber takes up water"
      }
    ],
    "views": [
      {
        "index": 1,
        "captured": "2024-07",
        "heading_deg": 40,
        "distance_m": 14.2,
        "shows_target": true,
        "side": "front",
        "quality": "good",
        "note": "Front elevation in good light"
      }
    ],
    "kpis": [
      {
        "key": "facade_condition",
        "label": "Facade condition",
        "value": 68,
        "unit": "/100",
        "status": "watch",
        "basis": "fair"
      }
    ],
    "limitations": "Rear elevation not visible from the street.",
    "generated_at": "2026-10-02T09:13:21+00:00"
  }
}

Insurance assessment

scopeinsurance→ keyinsuranceHOMAI analysis

The insurance reading of the roof and site, with underwriting notes for pricing and terms.

Fields of the insurance section
FieldTypeDescription
classificationstring | nullInsurance classification (for example Standard, Elevated).
summarystring | nullPlain-English insurance summary.
recommendations[]string[] | nullInsurance recommendations.
underwritingobject | nullheadline, story, risk_class (preferred, standard, elevated or high), perils[], underwriting_notes[], loss_prevention[], inspection, data_gaps[], kpis[], generated_at.
underwriting.perils[]arrayperil (water_ingress, storm, snow_load, flood, landslide, quick_clay, avalanche_rockfall, storm_surge, precipitation, fire, ageing), rating (low, moderate, elevated, high), evidence.
underwriting.loss_prevention[]arrayaction, priority (now, within_1y, within_3y, monitor), why.
underwriting.inspectionobjectrecommended (boolean), focus[].
Example
{
  "insurance": {
    "classification": "Standard",
    "summary": "A detached house with a mature tiled roof in fair condition; moderate climate exposure.",
    "recommendations": ["Moss removal and a flashing check within a year"],
    "underwriting": {
      "headline": "Standard roof risk with maintenance due on the north slopes.",
      "story": "A 1934 detached house with a 177 m² tiled gable roof in fair condition …",
      "risk_class": "standard",
      "perils": [
        {
          "peril": "water_ingress",
          "rating": "moderate",
          "evidence": "Moss on the lower courses; one chimney"
        }
      ],
      "underwriting_notes": ["No roof renewal seen since 1984"],
      "loss_prevention": [
        {
          "action": "Remove moss and check the chimney flashing",
          "priority": "within_1y",
          "why": "Moss holds water against the tiles"
        }
      ],
      "inspection": {
        "recommended": false,
        "focus": []
      },
      "data_gaps": ["Underlay condition is not visible"],
      "kpis": [
        {
          "key": "roof_risk",
          "label": "Roof risk index",
          "value": 41,
          "unit": "/100",
          "status": "watch",
          "basis": "higher = riskier"
        }
      ],
      "generated_at": "2026-10-02T09:12:55+00:00"
    }
  }
}

Maintenance plan

scopemaintenance→ keymaintenanceHOMAI analysis

Every building part HOMAI can see, with condition, remaining life, the next measure, its year and cost; a 5- and a 30-year plan.

Fields of the maintenance section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.parts[]arraypart, condition (good, fair, poor, unknown), evidence, remaining_life_years, next_action, year, priority (now, within_1y, within_3y, within_5y, later), cost_range_nok.
assessment.plan_5y[] / plan_30y[]string[]The plan by year and by five-year period.
Example
{
  "maintenance": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "headline": "Well kept, but the 1955 tile roof is at the end of its service life.",
      "parts": [
        {
          "part": "Roof covering (concrete tiles)",
          "condition": "fair",
          "remaining_life_years": "5-10",
          "next_action": "Re-roof with new underlay",
          "year": 2029,
          "priority": "within_5y",
          "cost_range_nok": "189 000–296 000"
        }
      ],
      "plan_5y": ["2026: clean gutters and check flashings"]
    }
  }
}

Energy & solar

scopeenergy→ keyenergyHOMAI analysis

Estimated energy class for the building's era and size, upgrade measures, and the solar yield of every measured roof plane.

Fields of the energy section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.estimated_classstringA–G or unknown (an estimate, not an energy certificate).
assessment.measures[]arraymeasure, effect, when, support.
eraobjectbuild_year, typical_kwh_per_m2_year, typical_class.
solarobjectplanes[] (facing, pitch_deg, area_m2, panel_kwp, kwh_per_kwp_year, kwh_year), best_planes_kwh_year, best_planes_kwp, assumptions.
Example
{
  "energy": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "estimated_class": "F",
      "measures": [
        {
          "measure": "Air-to-air heat pump",
          "effect": "Large cut in heating use",
          "when": "Any time",
          "support": "none"
        }
      ]
    },
    "era": {
      "build_year": 1955,
      "typical_kwh_per_m2_year": 250,
      "typical_class": "F"
    },
    "solar": {
      "best_planes_kwp": 12.6,
      "best_planes_kwh_year": 11476
    }
  }
}

HOMAI market data

scopemarket→ keymarketHOMAI analysis

The property's own listings and price history, renovations with years and condition remarks from the listing texts, and the area's price per m² by property type.

Fields of the market section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.price_positionstringbelow_area, around_area, above_area or unknown.
assessment.renovations[]arraypart, year, note.
market.this_property[]arraystatus, price_suggestion, price_total, price_per_m2, construction_year, areas, history[], neighbourhood[].
market.areaobjectradius_m, months, count, price_per_m2 by property type (active / closed: n, median_per_m2, low, high), nearby[].
Example
{
  "market": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "price_position": "above_area",
      "renovations": [
        {
          "part": "windows",
          "year": "2011",
          "note": "Wooden windows with insulated glass"
        }
      ]
    },
    "market": {
      "area": {
        "radius_m": 800,
        "count": 26,
        "price_per_m2": {
          "Enebolig": {
            "active": {
              "n": 2,
              "median_per_m2": 32848,
              "low": 29026,
              "high": 36671
            }
          }
        }
      }
    }
  }
}

Trees

scopetrees→ keytreesHOMAI analysis

The trees round the building with species, height and crown, and what they mean: falling on the house, crowns over the roof, shade, gutters.

Fields of the trees section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.risks[]arrayrisk (fall_on_house, crown_over_roof, roof_shade, gutters, roots, fire, none), rating, evidence.
treesobjectwithin_30m, species_mix, tallest_m, can_reach_house, crown_over_roof, shading_roof, trees[] (species, height_m, crown_m, distance_to_wall_m, direction_deg, flags).
Example
{
  "trees": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "risks": [
        {
          "risk": "fall_on_house",
          "rating": "moderate",
          "evidence": "One 11.5 m deciduous tree 9.6 m from the wall"
        }
      ]
    },
    "trees": {
      "within_30m": 4,
      "species_mix": {
        "deciduous": 3,
        "spruce": 1
      },
      "can_reach_house": 1,
      "crown_over_roof": 0,
      "shading_roof": 0
    }
  }
}

Area

scopearea→ keyareaHOMAI analysis

What is near the home: public transport stops with their modes, schools and kindergartens (with pupils), shops, health care, parks, sports.

Fields of the area section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.scores[]arraytopic, rating (excellent, good, fair, poor, unknown), evidence.
area_factsobjectpublic_transport[] and one object per category (count or count_within_2km, nearest[] with distance_m); unavailable[] lists categories that could not be checked.
Example
{
  "area": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "scores": [
        {
          "topic": "public_transport",
          "rating": "good",
          "evidence": "Bus stop 117 m away"
        }
      ]
    },
    "area_facts": {
      "public_transport": [
        {
          "name": "Rabben",
          "modes": ["bus"],
          "distance_m": 117
        }
      ],
      "schools": {
        "count_within_2km": 1,
        "nearest": [
          {
            "name": "Siggerud skole",
            "pupils": 393,
            "distance_m": 1788
          }
        ]
      },
      "unavailable": []
    }
  }
}

HOMAI risk score

scoperisk_score→ keyrisk_scoreHOMAI analysis

One explained risk score for lenders and insurers: roof condition, building age, natural hazards, trees, urgent maintenance and climate change.

Fields of the risk_score section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
scoreobjectscore (0-100, higher is riskier), grade (A–E), components[] (key, label, score, weight_pct, basis), scale.
assessment.lower_the_score[] / for_lenders[] / for_insurers[]string[]What would lower it and notes per audience.
Example
{
  "risk_score": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "score": {
      "score": 52,
      "grade": "D",
      "components": [
        {
          "key": "roof",
          "label": "Roof condition",
          "score": 51,
          "weight_pct": 37,
          "basis": "HOMAI roof index 51/100"
        }
      ]
    },
    "assessment": {
      "lower_the_score": ["Have a roofer check the tiles"]
    }
  }
}

Future climate

scopeclimate_future→ keyclimate_futureHOMAI analysis

Projected change at the building's 1 km cell to 2041–2070 and 2071–2100 under medium and high emissions, and what to plan for.

Fields of the climate_future section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.changes[]arraytopic (heavy_rain, rain, snow_load, freeze_thaw, temperature, wind, frost), direction, figure, impact.
projectionsobjectscenarios, periods, baseline, indices{} (unit, meaning, values per scenario and period).
Example
{
  "climate_future": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "changes": [
        {
          "topic": "heavy_rain",
          "direction": "more",
          "figure": "+14.3 % (high emissions, 2071-2100)",
          "impact": "Gutters and downpipes need more capacity"
        }
      ]
    },
    "projections": {
      "baseline": "1991-2020",
      "periods": ["2041-2070", "2071-2100"]
    }
  }
}

Contractors

scopecontractors→ keycontractorsHOMAI analysis

The trades the findings call for, a ready-to-send request for a quote per trade, and active local firms from the official company register.

Fields of the contractors section
FieldTypeDescription
generated_atstringWhen the report was made (ISO 8601).
assessmentobjectHOMAI AI's reading: headline, story and the lists below.
assessment.trades[]arraytrade, trade_label, why, urgency, job_description_no, job_description_en, questions_to_ask[], firms[] (name, org_nr, address, phone, email, employees).
Example
{
  "contractors": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "trades": [
        {
          "trade": "roofer",
          "urgency": "within_1y",
          "job_description_no": "Vi ønsker et skriftlig tilbud på …",
          "firms": [
            {
              "name": "Example Tak AS",
              "org_nr": "999999999",
              "phone": "22 00 00 00"
            }
          ]
        }
      ]
    }
  }
}

Image references

scopeimages→ keyimagesHOMAI analysis

First-party image references saved on the matched property (for example dated photos added by your team). Returned only when a saved property is matched.

Fields of the images section
FieldTypeDescription
images[].urlstringLink to the image.
images[].typestringhistorical or oblique.
images[].yearinteger | nullYear the image shows.
images[].labelstringCaption.
images_notestringReminder of what the list contains.
Example
{
  "images": [
    {
      "url": "https://files.example.com/tuengen-10-1984.jpg",
      "type": "historical",
      "year": 1984,
      "label": "Front, 1984"
    }
  ],
  "images_note": "Only first-party image references are returned."
}

Examples

By building number

curl -s "https://your-homai-host/api/v1/property?building_number=80107137" \
  -H "X-API-Key: $HOMAI_API_KEY"

By coordinates

curl -s "https://your-homai-host/api/v1/property?lat=59.93964&lng=10.69808" \
  -H "X-API-Key: $HOMAI_API_KEY"

By saved property

curl -s "https://your-homai-host/api/v1/property?id=1042" \
  -H "X-API-Key: $HOMAI_API_KEY"

A complete answer

A key holding every scope, asking for building_number=80107137 (Tuengen allé 10, 0374 Oslo). Values are examples, and long lists are shortened.

Response · 200 OK
{
  "ok": true,
  "point": {
    "lat": 59.9396431,
    "lng": 10.6980801
  },
  "maintenance": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "headline": "Well kept, but the 1955 tile roof is at the end of its service life.",
      "parts": [
        {
          "part": "Roof covering (concrete tiles)",
          "condition": "fair",
          "remaining_life_years": "5-10",
          "next_action": "Re-roof with new underlay",
          "year": 2029,
          "priority": "within_5y",
          "cost_range_nok": "189 000–296 000"
        }
      ],
      "plan_5y": ["2026: clean gutters and check flashings"]
    }
  },
  "energy": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "estimated_class": "F",
      "measures": [
        {
          "measure": "Air-to-air heat pump",
          "effect": "Large cut in heating use",
          "when": "Any time",
          "support": "none"
        }
      ]
    },
    "era": {
      "build_year": 1955,
      "typical_kwh_per_m2_year": 250,
      "typical_class": "F"
    },
    "solar": {
      "best_planes_kwp": 12.6,
      "best_planes_kwh_year": 11476
    }
  },
  "market": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "price_position": "above_area",
      "renovations": [
        {
          "part": "windows",
          "year": "2011",
          "note": "Wooden windows with insulated glass"
        }
      ]
    },
    "market": {
      "area": {
        "radius_m": 800,
        "count": 26,
        "price_per_m2": {
          "Enebolig": {
            "active": {
              "n": 2,
              "median_per_m2": 32848,
              "low": 29026,
              "high": 36671
            }
          }
        }
      }
    }
  },
  "trees": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "risks": [
        {
          "risk": "fall_on_house",
          "rating": "moderate",
          "evidence": "One 11.5 m deciduous tree 9.6 m from the wall"
        }
      ]
    },
    "trees": {
      "within_30m": 4,
      "species_mix": {
        "deciduous": 3,
        "spruce": 1
      },
      "can_reach_house": 1,
      "crown_over_roof": 0,
      "shading_roof": 0
    }
  },
  "area": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "scores": [
        {
          "topic": "public_transport",
          "rating": "good",
          "evidence": "Bus stop 117 m away"
        }
      ]
    },
    "area_facts": {
      "public_transport": [
        {
          "name": "Rabben",
          "modes": ["bus"],
          "distance_m": 117
        }
      ],
      "schools": {
        "count_within_2km": 1,
        "nearest": [
          {
            "name": "Siggerud skole",
            "pupils": 393,
            "distance_m": 1788
          }
        ]
      },
      "unavailable": []
    }
  },
  "risk_score": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "score": {
      "score": 52,
      "grade": "D",
      "components": [
        {
          "key": "roof",
          "label": "Roof condition",
          "score": 51,
          "weight_pct": 37,
          "basis": "HOMAI roof index 51/100"
        }
      ]
    },
    "assessment": {
      "lower_the_score": ["Have a roofer check the tiles"]
    }
  },
  "climate_future": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "changes": [
        {
          "topic": "heavy_rain",
          "direction": "more",
          "figure": "+14.3 % (high emissions, 2071-2100)",
          "impact": "Gutters and downpipes need more capacity"
        }
      ]
    },
    "projections": {
      "baseline": "1991-2020",
      "periods": ["2041-2070", "2071-2100"]
    }
  },
  "contractors": {
    "generated_at": "2026-10-25T03:12:40+00:00",
    "assessment": {
      "trades": [
        {
          "trade": "roofer",
          "urgency": "within_1y",
          "job_description_no": "Vi ønsker et skriftlig tilbud på …",
          "firms": [
            {
              "name": "Example Tak AS",
              "org_nr": "999999999",
              "phone": "22 00 00 00"
            }
          ]
        }
      ]
    }
  },
  "property": {
    "id": 1042,
    "label": "Tuengen allé 10, 0374 Oslo",
    "category": "Residential",
    "lat": 59.9396431,
    "lng": 10.6980801
  },
  "building": {
    "building_number": 80107137,
    "match": "building_number",
    "type": "Enebolig",
    "type_code": "111",
    "status": "Ferdigattest",
    "status_date": null,
    "business_group": "Annet som ikke er næring",
    "estimated_build_year": 1934,
    "estimated_build_date": "1934-03-08",
    "floors_registered": 2,
    "floors_estimated": 3,
    "dwelling_units": 1,
    "usable_area_m2": 254,
    "gross_area_m2": 381,
    "wall_area_m2": 368,
    "wall_height_max_m": 7.48,
    "wall_height_mean_m": 5.73,
    "verandas": 0,
    "veranda_area_m2": 0,
    "roof_type_registered": "Saltak",
    "roof_type_registered_label": "Gable",
    "flat_roof_registered": false,
    "roof_area_2d_m2": 168,
    "roof_area_3d_m2": 177,
    "roof_pitch_mean_deg": 15.3,
    "roof_pitch_max_deg": 19.8,
    "heritage": {
      "cultural_heritage": false,
      "sefrak": false
    },
    "registered_hazards": null,
    "address": {
      "text": "Tuengen allé 10, Oslo",
      "street": "Tuengen allé",
      "house_number": 10,
      "letter": null,
      "postal_code": "0374",
      "postal_place": "Oslo",
      "municipality": "Oslo",
      "municipality_number": "0301",
      "county": "Oslo",
      "address_id": "03011780200100000000",
      "lat": 59.9396849,
      "lng": 10.6980191
    },
    "parcel": {
      "unit_id": "03010003601480000000",
      "municipality_number": "0301",
      "gnr": 36,
      "bnr": 148,
      "fnr": 0,
      "snr": 0,
      "label": "0301-36/148"
    },
    "other_buildings_on_parcel": [],
    "location": {
      "lat": 59.9396431,
      "lng": 10.6980801
    },
    "as_of": "2026-09-14T15:50:06+00:00"
  },
  "roof_geometry": {
    "building_number": 80107137,
    "summary": {
      "roof_class": "gable",
      "roof_type_label": "Gable",
      "measured_class": "hip",
      "roof_type_registered": "Saltak",
      "plane_count": 7,
      "significant_plane_count": 7,
      "sloped_plane_count": 6,
      "flat_plane_count": 1,
      "area_3d_m2": 177.3,
      "area_2d_m2": 168.7,
      "slope_factor": 1.051,
      "pitch_dominant_deg": 18.6,
      "pitch_sloped_mean_deg": 18.6,
      "pitch_min_deg": 18.3,
      "pitch_max_deg": 19.8,
      "pitch_class": "medium",
      "flat_area_m2": 13.4,
      "flat_ratio": 0.075,
      "orientation_count": 4,
      "orientations": [
        {
          "facing": "SSW",
          "aspect_deg": 207,
          "area_m2": 50.6,
          "planes": 1
        },
        {
          "facing": "NNE",
          "aspect_deg": 27,
          "area_m2": 50,
          "planes": 2
        },
        {
          "facing": "ESE",
          "aspect_deg": 117,
          "area_m2": 32,
          "planes": 1
        },
        {
          "facing": "WNW",
          "aspect_deg": 297,
          "area_m2": 31.3,
          "planes": 2
        }
      ],
      "sector_area_m2": {
        "N": 0,
        "NE": 50,
        "E": 0,
        "SE": 32,
        "S": 0,
        "SW": 50.6,
        "W": 0,
        "NW": 31.3
      },
      "north_facing_ratio": 0.305,
      "south_facing_ratio": 0.309,
      "dominant_facing": "SSW",
      "eave_height_min_m": 5.3,
      "eave_height_max_m": 7.2,
      "eave_height_main_m": 7,
      "ridge_height_m": 8.6,
      "solar_suitable_area_m2": 82.6,
      "solar_suitable_planes": 2,
      "solar_irradiance_kwh_m2_year": null,
      "bbox": [10.6979151, 59.9395687, 10.6982452, 59.9397175],
      "center": [10.6980801, 59.9396431]
    },
    "planes": [
      {
        "id": "930110162811",
        "pitch_deg": 18.3,
        "aspect_deg": 207,
        "facing": "SSW",
        "area_3d_m2": 50.6,
        "area_2d_m2": 48,
        "length_m": 5.25,
        "width_m": 14.53,
        "eave_height_m": 7,
        "top_height_m": 8.6,
        "top_elevation_m": 89.6,
        "solar_kwh_m2_year": null,
        "outline": [
          [10.6981096, 59.9396387],
          [10.698146, 59.9395789],
          [10.6979151, 59.9396387],
          [10.6980322, 59.9396582],
          [10.6981096, 59.9396387]
        ]
      },
      {
        "id": "930110162816",
        "pitch_deg": 18.4,
        "aspect_deg": 27,
        "facing": "NNE",
        "area_3d_m2": 41.1,
        "area_2d_m2": 39,
        "length_m": 5.23,
        "width_m": 11.57,
        "eave_height_m": 7,
        "top_height_m": 8.6,
        "top_elevation_m": 89.6,
        "solar_kwh_m2_year": null,
        "outline": [
          [10.6981572, 59.9396476],
          [10.6981096, 59.9396387],
          [10.6980322, 59.9396582],
          [10.6979959, 59.9397175],
          [10.6981331, 59.939682],
          [10.6981572, 59.9396476]
        ]
      }
    ],
    "as_of": "2026-09-14T15:50:06+00:00"
  },
  "imagery": {
    "years": [1937, 1947, 1956, 1971, 1984, 1997, 2004, 2010, 2016, 2020, 2022, 2024, 2025, 2026],
    "year_count": 14,
    "first_year": 1937,
    "latest_year": 2026,
    "capture_count": 48,
    "current": {
      "year": 2026,
      "season": "spring",
      "ground_resolution_m": 0.08
    },
    "infrared_year": 2025,
    "history": [
      {
        "year": 1937,
        "season": null,
        "ground_resolution_m": null
      },
      {
        "year": 1947,
        "season": null,
        "ground_resolution_m": null
      },
      {
        "year": 2026,
        "season": "spring",
        "ground_resolution_m": 0.08
      }
    ]
  },
  "eiendom": {
    "ok": true,
    "lat": 59.9396431,
    "lng": 10.6980801,
    "elevation": 81.1,
    "address": {
      "label": "Tuengen allé 10",
      "street": "Tuengen allé",
      "number": "10",
      "letter": "",
      "postal_code": "0374",
      "postal_place": "OSLO",
      "municipality": "OSLO",
      "municipality_nr": "0301",
      "lat": 59.9396849,
      "lng": 10.6980191
    },
    "matrikkel": {
      "kommunenummer": "0301",
      "gardsnummer": "36",
      "bruksnummer": "148",
      "festenummer": "0",
      "seksjonsnummer": "0",
      "display": "0301-36/148"
    },
    "eiendom": {
      "land_area": 812,
      "units": 1,
      "buildings": [
        {
          "number": 80107137,
          "type": "Enebolig",
          "status": "Ferdigattest",
          "build_year": 1934,
          "gross_area": 254,
          "floors": 2
        }
      ]
    },
    "places": [
      {
        "name": "Vinderen",
        "type": "Bydel",
        "distance": null
      }
    ],
    "weather": {
      "current": {
        "temperature_2m": 6.3,
        "apparent_temperature": 2.8,
        "relative_humidity_2m": 69,
        "precipitation": 0,
        "weather_code": 3,
        "wind_speed_10m": 3,
        "wind_gusts_10m": 5.5
      },
      "timezone": "GMT+2"
    }
  },
  "climate": {
    "ok": true,
    "climate_score": {
      "value": 3.5,
      "max": 10,
      "level": "Low",
      "sample": false,
      "weights": {
        "precipitation": 0.25,
        "landslide": 0.25,
        "flooding": 0.25,
        "storm": 0.25,
        "quick_clay": 0.35,
        "avalanche_rockfall": 0.25,
        "storm_surge": 0.3,
        "radon": 0.05
      },
      "breakdown": [
        {
          "key": "precipitation",
          "label": "Extreme Precipitation",
          "band": 3,
          "weight": 0.25,
          "contribution": 1.5
        },
        {
          "key": "landslide",
          "label": "Landslide",
          "band": 1,
          "weight": 0.25,
          "contribution": 0.5
        },
        {
          "key": "flooding",
          "label": "Flooding",
          "band": 1,
          "weight": 0.25,
          "contribution": 0.5
        },
        {
          "key": "storm",
          "label": "Storm",
          "band": 2,
          "weight": 0.25,
          "contribution": 1
        },
        {
          "key": "quick_clay",
          "label": "Quick clay",
          "band": 1,
          "weight": 0.35,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        },
        {
          "key": "avalanche_rockfall",
          "label": "Snow avalanche & rockfall",
          "band": 1,
          "weight": 0.25,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        },
        {
          "key": "storm_surge",
          "label": "Storm surge & sea level",
          "band": 1,
          "weight": 0.3,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        },
        {
          "key": "radon",
          "label": "Radon",
          "band": 2,
          "weight": 0.05,
          "contribution": null,
          "location_hazard": true,
          "counted": false
        }
      ]
    },
    "hazards": [
      {
        "key": "landslide",
        "name": {
          "no": "Jordskred",
          "en": "Landslide"
        },
        "icon": "mountain",
        "level": "Low",
        "exposure": {
          "key": "svaert_lav",
          "no": "Svært lav",
          "en": "Very low",
          "band": 1,
          "scale": [
            {
              "key": "svaert_lav",
              "no": "Svært lav",
              "en": "Very low",
              "band": 1
            }
          ]
        },
        "rationale": {
          "no": "Området ligger utenfor kartlagte aktsomhetssoner for jord- og flomskred.",
          "en": "The area is outside mapped landslide susceptibility zones."
        },
        "why": {
          "no": "Helning og grunnforhold indikerer potensial for ustabile masser.",
          "en": "Slope and soil conditions indicate a moderate potential for slope instability."
        },
        "consequences": [
          {
            "no": "Skader på yttervegg og knuste vinduer.",
            "en": "Damage to exterior walls and broken windows."
          }
        ],
        "measures": [
          {
            "no": "Installere fysiske barrierer for å avlede nedfall.",
            "en": "Install physical barriers to divert debris."
          }
        ],
        "sample": false,
        "rating": "measured"
      }
    ],
    "biodiversity": {
      "key": "biodiversity",
      "informational": true,
      "sensitivity": {
        "key": "moderat",
        "no": "Moderat",
        "en": "Moderate",
        "band": 3
      },
      "forest": {
        "is_forest": false,
        "type": null,
        "bonitet": null,
        "no": "Bebygd og samferdsel",
        "en": "Built-up / transport"
      },
      "species": {
        "count_distinct": 51,
        "nearest_m": 524,
        "by_category": {
          "NT": 30,
          "VU": 12,
          "EN": 7,
          "CR": 2
        },
        "radius_km": 2,
        "note": "recorded nearby",
        "status": "ok"
      }
    },
    "land_cover": {
      "artype": 10,
      "no": "Bebygd og samferdsel",
      "en": "Built-up / transport"
    },
    "generated_at": "2026-10-09T21:20:23+00:00"
  },
  "plan": {
    "ok": true,
    "zones": [
      {
        "layer": "RpArealformålOmrade",
        "fields": {
          "planidentifikasjon": "S-4129",
          "arealformål": "Boligbebyggelse"
        }
      }
    ],
    "generated_at": "2026-10-09T21:20:30+00:00"
  },
  "terrain": {
    "ok": true,
    "ground_elev_m": 81,
    "surface_elev_m": 89.6,
    "building_height_m": 8.6,
    "terrain_slope_deg": 3.4,
    "aspect": "SW",
    "relative_height_m": 1.1,
    "flood_runoff_note": "Moderate terrain drainage.",
    "generated_at": "2026-10-09T21:20:36+00:00"
  },
  "roof": {
    "risk_score": 41,
    "risk_level": "Medium",
    "roof_assessed": true,
    "facts": {
      "type": "gable",
      "plane_count": 7,
      "pitch_degrees": 18.6,
      "pitch_class": "medium",
      "material": "tile",
      "condition": "fair",
      "defects": ["moss", "wear"],
      "flat_section_ratio": 0.08,
      "penetrations": {
        "chimneys": 1,
        "roof_windows": 2,
        "vents": 2,
        "confidence": 0.6
      },
      "drainage_visible": "adequate",
      "confidence": 0.8
    },
    "risk_breakdown": {
      "risk_index": 41,
      "breakdown": {
        "age": {
          "label": "Roof Age",
          "score": 58,
          "weight": 0.2315,
          "contribution": 13.43
        },
        "visible_defects": {
          "label": "Visible Defects",
          "score": 44,
          "weight": 0.1389,
          "contribution": 6.11
        }
      },
      "weighted_sum": 40.2,
      "confidence_drag": 0.8,
      "confidence": 0.84,
      "factor_count": 10
    },
    "overall_condition": "Fair",
    "main_risk": "Moss and wear on the north-facing tiled slopes",
    "confidence": 0.8,
    "remaining_lifespan": "10–20 years with maintenance",
    "inspection_interval": "2 years",
    "summary": "A 1934 detached house with a tiled gable roof of about 177 m² at an 18.6° pitch. The covering is in fair condition with moss on the shaded slopes.",
    "recommendations": ["Remove moss from the north-facing slopes", "Check flashings around the chimney"],
    "building_number": 80107137,
    "analysed_at": "2026-10-02T09:12:40+00:00"
  },
  "roof_heatmap": {
    "condition_index": 84,
    "condition_band": "fair",
    "covering": "tile",
    "image_quality": "good",
    "roof_surface_m2": 176.2,
    "affected_m2": 9.6,
    "defect_m2": 0,
    "repaired_m2": 3.1,
    "unassessable_share": 0.04,
    "state_counts": {
      "ok": 18,
      "moss": 3,
      "wear": 2,
      "patch": 1,
      "obstructed": 1
    },
    "hotspots": [
      {
        "cell": "C2",
        "plane": 2,
        "state": "moss",
        "severity": 1,
        "confidence": 0.7,
        "change": "persisting",
        "note": "Moss along the lower courses"
      }
    ],
    "planes": [
      {
        "plane": 2,
        "facing": "NNE",
        "pitch_deg": 18.4,
        "area_m2": 41.1,
        "condition_index": 80,
        "condition_band": "fair",
        "worst_state": "moss",
        "affected_share": 0.21,
        "cells": 7
      }
    ],
    "grid": {
      "columns": 6,
      "rows": 5,
      "cell_size_m": 2.9
    },
    "cells": [
      {
        "cell": "C2",
        "column": 2,
        "row": 1,
        "plane": 2,
        "state": "moss",
        "severity": 1,
        "confidence": 0.7,
        "change": "persisting",
        "repair": false,
        "heat": 0.29,
        "area_m2": 7.9,
        "note": "Moss along the lower courses"
      },
      {
        "cell": "D4",
        "column": 3,
        "row": 3,
        "plane": 1,
        "state": "ok",
        "severity": 0,
        "confidence": 1,
        "change": "unknown",
        "repair": false,
        "heat": 0,
        "area_m2": 8.4,
        "note": null
      }
    ],
    "image_year": 2026,
    "compared_with_year": 2019,
    "summary": "The tiled roof is largely sound; moss sits along the lower courses of the north-facing slope and one small patch repair shows near the chimney.",
    "limitations": "Tree shadow on the west side limits certainty on two cells.",
    "generated_at": "2026-10-02T09:11:58+00:00"
  },
  "facade": {
    "headline": "Painted timber facade in fair order, with weathered paint on the south-west side.",
    "target_visible": true,
    "condition": {
      "grade": "fair",
      "index": 68,
      "summary": "Timber cladding is intact; paint is weathered on the sunny side and window sills need attention."
    },
    "facade": {
      "storeys_visible": 2,
      "materials": ["timber cladding"],
      "colour": "white",
      "style_era": "1930s detached house",
      "windows": "Painted timber frames",
      "balconies": "None visible",
      "entrances": "Front door with a small porch"
    },
    "findings": [
      {
        "element": "Paint (south-west wall)",
        "issue": "Weathered and flaking paint",
        "severity": 2,
        "confidence": 0.6,
        "view": 1
      }
    ],
    "remaining_life": [
      {
        "element": "Timber cladding",
        "years_low": 15,
        "years_high": 30,
        "basis": "Sound boards; repaint every 8–12 years"
      }
    ],
    "maintenance": [
      {
        "when": "within_1y",
        "action": "Repaint the south-west wall",
        "why": "Bare timber takes up water"
      }
    ],
    "views": [
      {
        "index": 1,
        "captured": "2024-07",
        "heading_deg": 40,
        "distance_m": 14.2,
        "shows_target": true,
        "side": "front",
        "quality": "good",
        "note": "Front elevation in good light"
      }
    ],
    "kpis": [
      {
        "key": "facade_condition",
        "label": "Facade condition",
        "value": 68,
        "unit": "/100",
        "status": "watch",
        "basis": "fair"
      }
    ],
    "limitations": "Rear elevation not visible from the street.",
    "generated_at": "2026-10-02T09:13:21+00:00"
  },
  "insurance": {
    "classification": "Standard",
    "summary": "A detached house with a mature tiled roof in fair condition; moderate climate exposure.",
    "recommendations": ["Moss removal and a flashing check within a year"],
    "underwriting": {
      "headline": "Standard roof risk with maintenance due on the north slopes.",
      "story": "A 1934 detached house with a 177 m² tiled gable roof in fair condition …",
      "risk_class": "standard",
      "perils": [
        {
          "peril": "water_ingress",
          "rating": "moderate",
          "evidence": "Moss on the lower courses; one chimney"
        }
      ],
      "underwriting_notes": ["No roof renewal seen since 1984"],
      "loss_prevention": [
        {
          "action": "Remove moss and check the chimney flashing",
          "priority": "within_1y",
          "why": "Moss holds water against the tiles"
        }
      ],
      "inspection": {
        "recommended": false,
        "focus": []
      },
      "data_gaps": ["Underlay condition is not visible"],
      "kpis": [
        {
          "key": "roof_risk",
          "label": "Roof risk index",
          "value": 41,
          "unit": "/100",
          "status": "watch",
          "basis": "higher = riskier"
        }
      ],
      "generated_at": "2026-10-02T09:12:55+00:00"
    }
  },
  "images": [
    {
      "url": "https://files.example.com/tuengen-10-1984.jpg",
      "type": "historical",
      "year": 1984,
      "label": "Front, 1984"
    }
  ],
  "images_note": "Only first-party image references are returned.",
  "unavailable": [],
  "attribution": "© HOMAI",
  "credits": [
    "Contains open data from NVE, NIBIO, MET Norway, Kartverket and NGU (NLOD / CC BY 4.0)",
    "Contains planning data from Kartverket / Geonorge (CC BY 4.0)",
    "Contains elevation data © Kartverket (CC BY 4.0)",
    "Contains property register data © Kartverket (CC BY 4.0)"
  ]
}

Errors

Errors are JSON with ok: false and a stable error code. Match on the code, not on the message text.

{
  "ok": false,
  "error": "rate_limited",
  "retry_after_s": 60
}
Error codes
StatuserrorMeaningCounted
400provide id, lat+lng, or addressNo location could be resolved from the parameters.Yes
401invalid_or_missing_api_keyNo key, an unknown key or a revoked key.No
403forbidden_categoryThe matched saved property is outside the categories your key may read.Yes
404building_not_foundHOMAI holds no building with that building_number.Yes
404unknown_endpointThe path is not a v1 endpoint.No
405method_not_allowedEndpoints accept GET only.No
429rate_limitedYour key's per-minute limit is used up. Retry after retry_after_s seconds.No
500internal_errorSomething failed on HOMAI's side. Retry later; contact us if it persists.Yes

Coverage & freshness

Coverage

  • Building profiles, measured roofs and satellite image history: every building in Norway.
  • Site data (climate hazards, zones, terrain, property at the point): any point in Norway.
  • HOMAI analysis: the buildings HOMAI has analysed for you.

Freshness

  • Building and roof records carry as_of, the time HOMAI last refreshed them.
  • New satellite years are added to the history as HOMAI receives them.
  • Climate hazards and zones are at most a week old; terrain readings at most a month. Current weather is live.
  • Analysis sections carry analysed_at / generated_at; ask HOMAI for a new analysis when you need one.

Getting access

  1. Contact your HOMAI account manager with the scopes you need and your expected request volume.
  2. HOMAI issues a key with those scopes, a per-minute limit and, if agreed, the property categories it may read. The key is shown once — store it in your secret manager.
  3. Send it in the X-API-Key header. Check /scopes to confirm what it holds.

Data returned by the API is licensed to you under your HOMAI agreement. All data and analysis © HOMAI.