Fetch information related to buildings
GET/building/information
Building Information Endpoint
Overview
This API returns information about a building or buildings based on a batch ID or property ID NMA.
It supports both single building retrieval and batch downloads.
It returns data about the building's size, location, addresses, industry code, building type, energy label, heating grade, cultural artifacts etc.
For more detailed info about floors, use the building floors endpoint. For more detailed info about the building history, use the building status history endpoint.
Example Request
- Fetch information based on batch ID:
curl -X 'GET' \
'https://apis.propcloud.no/api/public/building/information?batch-id=1' \
-H 'accept: application/json' \
-H 'api-key: YOUR_API_KEY'
- Fetch information based on property ID NMA:
curl -X 'GET' \
'https://apis.propcloud.no/api/public/building/information?property-id-nma=3301-111-52-0-0' \
-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 | PropCloud |
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 |
address | The physical address of the property. | Eiendommens fysiske adresse. | 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 |
energyGrade | The energy efficiency grade of the building, such as "E". | Bygningens energieffektivitetsgrad, for eksempel "E". | Kartverket |
heatingGrade | The heating efficiency grade, such as "Middels-hoy (82.5%)". | Varmekarakter, for eksempel "Middels-hoy (82.5%)". | Kartverket |
floors | The number of floors in the building. | Antall etasjer i bygningen. | 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 |
lat | Latitude coordinate of the property. | Breddegrad koordinat for eiendommen. | Kartverket |
lon | Longitude coordinate of the property. | Lengdegrad koordinat for eiendommen. | Kartverket |
cityName | Name of the city where the property is located. | Navn paa byen der eiendommen ligger. | Kartverket |
countyName | Name of the county where the property is located. | Navn paa fylket der eiendommen ligger. | Kartverket |
culturalArtifactId | Identifier for any cultural artifact associated with the property, if applicable. | Identifikator for kulturelle gjenstander tilknyttet eiendommen, hvis aktuelt. | Askeladden |
localityNumber | Number associated with the locality where the cultural artifact is situated. | Nummer tilknyttet lokaliteten der kulturminnet ligger. | Askeladden |
culturalMonumentNumber | Number associated with any cultural monument on the property, if applicable. | Nummer tilknyttet kulturelle monumenter paa eiendommen, hvis aktuelt. | Askeladden |
Request
Responses
- 200
- 422
Successful Response
Validation Error