Retrieve buildings owned by an organization with status history and postal code

GET 
/companies/overview/buildings

Company Buildings Overview Endpoint

Overview

This API returns all buildings owned by a given organization, including status history and postal code for each building.

It resolves the full ownership structure for the organization (including subsidiaries) to collect all associated property ID NMAs, then returns the corresponding building records deduplicated by building number.

The endpoint supports the following query parameters:

• organization-number: The organization number of the company to fetch building data for. / Organisasjonsnummeret til selskapet man ønsker bygningsdata for.
• only-majority-ownership: When set to true, only subsidiaries with ownership >50% are included. Defaults to false (all subsidiaries included). / Når satt til true, inkluderes kun datterselskaper med eierandel over 50%. Standard er false (alle datterselskaper inkluderes).

Example Request

curl -X 'GET' \
  'https://apis.propcloud.no/api/public/companies/overview/buildings?organization-number=810547472' \
  -H 'accept: application/json' \
  -H 'api-key: YOUR_API_KEY'

Response Description

Key	Description	Beskrivelse	Source
propertyId	Unique identifier for the property.	Unik identifikator for eiendommen. Feltet heter MatrikkelenhetId i Matrikkelen	Kartverket
propertyIdNma	Unique identifier for the property, generated based on city number, ground number, and other details.	Unik identifikator for eiendommen generert basert paa kommunenummer, gaardsnummer og andre detaljer.	PropCloud
buildingId	Unique identifier for the building. Additions / changes to a building gets a unique building id but keeps the same building number	Unik identifikator for bygningen. Paabygg / endinger paa bygning faar eget bygningsid, men beholder samme bygningsnummer. Feltet heter ByggId i Matrikkelen	PropCloud
buildingNumber	Unique identifier for the building. Building number assigned to the building.	Unik identifikator for bygningen. Feltet heter bygningsnummer i Matrikkelen	Kartverket
hasSefrakArtifact	Indicates whether the property has a SEFRAK-registered artifact.	Angir om eiendommen har en SEFRAK-registrert gjenstand.	Kartverket
hasCulturalArtifact	Indicates whether the property has a cultural artifact.	Angir om eiendommen har en kulturell gjenstand.	Kartverket
hasElevator	Indicates whether the building has an elevator.	Angir om bygningen har heis.	Kartverket
unitsHome	Number of residential units in the building.	Antall boligenheter i bygningen.	Kartverket
builtArea	Total built area of the property.	Totalt bebygd areal paa eiendommen.	Kartverket
gbaTotal	Total gross building area.	Totalt bruttoareal for bygningen.	Kartverket
ufsTotal	Total usable floor space in square meters.	Totalt bruksareal i kvadratmeter.	Kartverket
buildingStatusCodeName	Status description of the building, such as "Tatt i bruk" (In use).	Statusbeskrivelse av bygningen, for eksempel "Tatt i bruk".	Kartverket
industryGroupCodeName	Name of the industry group associated with the building, such as "Bolig" (Residential).	Navn paa bransjegruppen tilknyttet bygningen, for eksempel "Bolig".	Kartverket
industryGroupCodeValue	Code value representing the industry group, such as "X".	Kodeverdi som representerer bransjegruppen, for eksempel "X".	Kartverket
buildingTypeCodeName	Name of the building type, such as "Rekkehus" (Terraced house).	Navn paa bygningstypen, for eksempel "Rekkehus".	Kartverket
buildingTypeCodeValue	Code value representing the building type, such as "131".	Kodeverdi som representerer bygningstypen, for eksempel "131".	Kartverket
buildingChangeCodeName	Description of any recent changes to the building.	Beskrivelse av eventuelle nylige endringer i bygningen.	Kartverket
address	The physical address of the property.	Eiendommens fysiske adresse.	Kartverket
serialNumber	Serial number of the building. The first entry of the building always has serial number 0. If additions / changes are made to the building, the changes get serial number 1, 2. etc.	Lopenummer på bygningen. Den første oppføringen av bygningen har alltid serienummer 0. Hvis tillegg eller endringer gjøres på bygningen, får endringene serienummer 1, 2 osv.	Kartverket
floors	The number of floors in the building.	Antall etasjer i bygningen.	Kartverket
energyGrade	The energy efficiency grade of the building, such as "E".	Bygningens energieffektivitetsgrad, for eksempel "E".	Kartverket
heatingGradeLabel	The label part of the heating grade, such as "Middels-hoy".	Tekstdelen av varmekarakteren, for eksempel "Middels-hoy".	Kartverket
heatingGradeValue	The numeric percentage value of the heating grade, such as 82.5.	Den numeriske prosentverdien av varmekarakteren, for eksempel 82.5.	Kartverket
postalCode	The postal code where the building is located.	Postnummeret der bygningen er lokalisert.	Kartverket
lat	Latitude coordinate of the building.	Breddegrad koordinat for bygningen.	Kartverket
lon	Longitude coordinate of the building.	Lengdegrad koordinat for bygningen.	Kartverket
statusInformation	List of status history entries for the building	Liste over statushistorikk for bygningen	Kartverket
statusInformation[].buildingId	Unique identifier for the building. Additions / changes to a building gets a unique building id but keeps the same building number	Unik identifikator for bygningen. Paabygg / endinger paa bygning faar eget bygningsid, men beholder samme bygningsnummer. Feltet heter ByggId i Matrikkelen	PropCloud
statusInformation[].buildingStatusCodeId	Unique identifier for the building status code	Unik identifikator for bygningens statuskode	Kartverket
statusInformation[].date	Date the status was set	Datoen statusen ble satt	Kartverket
statusInformation[].buildingStatusCodeName	Status description of the building, such as "Tatt i bruk" (In use).	Statusbeskrivelse av bygningen, for eksempel "Tatt i bruk".	Kartverket
statusInformation[].buildingStatusCodeValue	Status code value representing the building status, such as "T" for "Tatt i bruk" (In use).	Statuskode som representerer bygningens status, for eksempel "T" for "Tatt i bruk".	Kartverket

Request

Responses

200

Successful Response

422

Validation Error