LookupPropertyByAddress2

Description

This method is the LookUpPropertyByAddress method modified to include the ShowTenants input parameter and Tenants output parameter which is an array of tenants. If ShowTenants is set to True, it returns Tenants of the specified address if there are any, along with the building and property details as in LookUpPropertyByAddress. If ShowTenants is set to False, it returns results similar to LookUpPropertyByAddress.


This method is used to retrieve property and tenant details along with plant information (if there is any) when the street address is provided. The property information is retrieved from Infoland service and combined with details like the boligmappaNumber if the property is already registered in Boligmappa. Tenant details are retrieved from Brreg API and Proff API for the given address. If the current user's company has already created the tenant for that particular building, results will contain the ConnectedBuildingPlantId too.


In addition, it provides plant information if the plant is created by a particular company of the current user. Results returned by this method includes the address, Matrikkel, basic building details and property owners. The results can either be zero, or one or more Property Plants which are returned as a list.
Properties located inside a particular building are associated to that building. Properties for which the main building could not be located due to the unavailability of data is separately displayed.

Important

In order to retrieve tenant information, professionals are required to have purchased a valid license consisting of the 'Tenant' feature in order to use this web method. Please contact per.christian@boligmappa.no or yohanw@99x.lk to get a license set up for your company.

Note: If you wish to lookup properties without 'ShowTenants' enabled, you do not require a license. The web method will work similarly to LookUpPropertyByAddress.

Request

ParameterTypeMandatory/OptionalMaximum character length/limitDescription
inputLookupPropertyByAddressInputMandatoryNot relevantLookup property by address input
applicationNamestringMandatoryShould be less than or equal to 10 charactersThe name of the integration partner
disableMetaDataboolOptionalNot relevantSwitch to new search to get properties (fast). (Exclude FloorCount,
UsedFrom,
Latitude and 
Longitude)
disableOwnerInfoboolOptionalNot relevantGet properties even faster without property owners.
(disableMetaData  must be true) 


Note

  • The search is based on all parameters that are provided.
  • municipalityNumber, ZipCode and HouseNumber are optional parameters that help Boligmappa to find the results quickly and more efficiently.
  • New search woks for (disableMetaData = true) seanrio and disableOwnerInfo cannot true without enabling disableMetaData.
  • We have given the priority to ShowTenants. If the ShowTenants is true, then the API ignore the disableMetaData and disableOwnerInfo scenarios.


Request - sample input

<LookupPropertyByAddress2>
  <MethodParameters>
    <UserAuthentication>
      <UserName>username</UserName>
      <Password>password</Password>
      <AnyAttr attr0="XmlAttributeArray" isNull="false">
        <XmlAttributeArray0>System.Xml.XmlAttribute</XmlAttributeArray0>
      </AnyAttr>
    </UserAuthentication>
    <input>
      <Address>
        <StreetName>Neptunvegen</StreetName>
        <HouseNumber>2</HouseNumber>
        <HouseLetter isNull="false" />
        <ZipCode>7652</ZipCode>
        <City>VERDAL</City>
      </Address>
      <MunicipalityNo>0</MunicipalityNo>
      <ShowTenants>True</ShowTenants>
    </input>
    <applicationName>test</applicationName>
    <disableMetaData>False</disableMetaData>
    <disableOwnerInfo>False</disableOwnerInfo>

  </MethodParameters>
</LookupPropertyByAddress2>

Response

TypeDescription
LookupPropertyByAddressOutputLookup property by address output


Response - sample output

<LookupPropertyByAddress2>
  <MethodParameters>
    <LookupPropertyByAddressOutput>
      <PlantArray>
        <PlantArray0 actualtype="BuildingPlant" basetype="Plant">
          <BuildingId>7594</BuildingId>
          <BoligmappaNumber>KAH5947</BoligmappaNumber>
          <BuildingNumber>6889913</BuildingNumber>
          <Iteration>0</Iteration>
          <BuildingTypeCode>231</BuildingTypeCode>
          <BuildingType>LAGERHALL</BuildingType>
          <BuildingStatus>TATT I BRUK</BuildingStatus>
          <Matrikkel>
            <Knr>231</Knr>
            <Gnr>70</Gnr>
            <Bnr>45</Bnr>
            <Fnr>0</Fnr>
            <Snr>0</Snr>
          </Matrikkel>
          <FloorCount>4</FloorCount>
          <PropertyCount>0</PropertyCount>
          <TotalBuildingArea>7503.0</TotalBuildingArea>
          <UtilizedBuildingArea>0.0</UtilizedBuildingArea>
          <UsedFrom>1992</UsedFrom>
          <Properties attr0="PropertyPlantArray" isNull="false">
            <PropertyPlantArray0>
              <PropertyCategory>R</PropertyCategory>
              <Matrikkel>
                <Knr>231</Knr>
                <Gnr>70</Gnr>
                <Bnr>45</Bnr>
                <Fnr>0</Fnr>
                <Snr>0</Snr>
              </Matrikkel>
              <ShareNumber>0</ShareNumber>
              <StreetAddress>Hvamsvingen 11, 2013 SKJETTEN</StreetAddress>
              <Address>
                <StreetName>Hvamsvingen</StreetName>
                <HouseNumber>11</HouseNumber>
                <HouseLetter isNull="true" />
                <ZipCode>2013</ZipCode>
                <City>SKJETTEN</City>
              </Address>
              <BoligmappaNumber isNull="true" />
              <UnitNumber isNull="true" />
              <PropertyType>LAGERHALL</PropertyType>
              <Latitude>59.97831820017</Latitude>
              <Longitude>11.0026517840142</Longitude>
              <MainBuildingNumber>6889913</MainBuildingNumber>
              <MainBuildingIteration>0</MainBuildingIteration>
              <PropertyOwners isNull="true" />
              <PlantId>0</PlantId>
              <PlantName isNull="true" />
              <CreatedTime isNull="true" />
            </PropertyPlantArray0>
            <PropertyPlantArray1>
              <PropertyCategory>S</PropertyCategory>
              <Matrikkel>
                <Knr>231</Knr>
                <Gnr>70</Gnr>
                <Bnr>45</Bnr>
                <Fnr>0</Fnr>
                <Snr>1</Snr>
              </Matrikkel>
              <ShareNumber>0</ShareNumber>
              <StreetAddress>Hvamsvingen 11, 2013 SKJETTEN</StreetAddress>
              <Address>
                <StreetName>Hvamsvingen</StreetName>
                <HouseNumber>11</HouseNumber>
                <HouseLetter isNull="true" />
                <ZipCode>2013</ZipCode>
                <City>SKJETTEN</City>
              </Address>
              <BoligmappaNumber isNull="true" />
              <UnitNumber>H0101</UnitNumber>
              <PropertyType>LAGERHALL</PropertyType>
              <Latitude>59.97831820017</Latitude>
              <Longitude>11.0026517840142</Longitude>
              <MainBuildingNumber>6889913</MainBuildingNumber>
              <MainBuildingIteration>0</MainBuildingIteration>
              <PropertyOwners attr0="PropertyOwnerArray" isNull="false">
                <PropertyOwnerArray0>
                  <FirstName>Hvam Eiendom</FirstName>
                  <LastName>AS</LastName>
                  <DefaultAddress isNull="true" />
                  <OrganizationNumber>968993860</OrganizationNumber>
                  <CompanyName isNull="true" />
                </PropertyOwnerArray0>
              </PropertyOwners>
              <PlantId>0</PlantId>
              <PlantName isNull="true" />
              <CreatedTime isNull="true" />
            </PropertyPlantArray1>
            <PropertyPlantArray2>
              <PropertyCategory>S</PropertyCategory>
              <Matrikkel>
                <Knr>231</Knr>
                <Gnr>70</Gnr>
                <Bnr>45</Bnr>
                <Fnr>0</Fnr>
                <Snr>2</Snr>
              </Matrikkel>
              <ShareNumber>0</ShareNumber>
              <StreetAddress>Hvamsvingen 11, 2013 SKJETTEN</StreetAddress>
              <Address>
                <StreetName>Hvamsvingen</StreetName>
                <HouseNumber>11</HouseNumber>
                <HouseLetter isNull="true" />
                <ZipCode>2013</ZipCode>
                <City>SKJETTEN</City>
              </Address>
              <BoligmappaNumber isNull="true" />
              <UnitNumber>H0102</UnitNumber>
              <PropertyType>LAGERHALL</PropertyType>
              <Latitude>59.97831820017</Latitude>
              <Longitude>11.0026517840142</Longitude>
              <MainBuildingNumber>6889913</MainBuildingNumber>
              <MainBuildingIteration>0</MainBuildingIteration>
              <PropertyOwners attr0="PropertyOwnerArray" isNull="false">
                <PropertyOwnerArray0>
                  <FirstName>Hvam Eiendom</FirstName>
                  <LastName>AS</LastName>
                  <DefaultAddress isNull="true" />
                  <OrganizationNumber>968993860</OrganizationNumber>
                  <CompanyName isNull="true" />
                </PropertyOwnerArray0>
              </PropertyOwners>
              <PlantId>0</PlantId>
              <PlantName isNull="true" />
              <CreatedTime isNull="true" />
            </PropertyPlantArray2>
          </Properties>
          <TenantArray>
            <TenantArray0>
              <OrganizationNumber>819391122</OrganizationNumber>
              <CompanyName>MALERMESTER BUER AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners isNull="false" />
              <ContactPersonName>Øystein Nesset</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray0>
            <TenantArray1>
              <OrganizationNumber>983618243</OrganizationNumber>
              <CompanyName>LUMINATOR AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners>AUD BØHN HELBERGET,PER ARNE HELBERGET</CompanyOwners>
              <ContactPersonName>Gjermund Sjøsaasen</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray1>
            <TenantArray2>
              <OrganizationNumber>986216316</OrganizationNumber>
              <CompanyName>BUER &amp; BRATFOSS AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners isNull="false" />
              <ContactPersonName>Odin Tangerud</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray2>
            <TenantArray3>
              <OrganizationNumber>983366295</OrganizationNumber>
              <CompanyName>BIL RINGEN K Rode</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners isNull="false" />
              <ContactPersonName>Ken Oddvind Rode</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray3>
            <TenantArray4>
              <OrganizationNumber>995216671</OrganizationNumber>
              <CompanyName>BUER GRUPPEN AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners isNull="false" />
              <ContactPersonName>Tore Buer</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray4>
            <TenantArray5>
              <OrganizationNumber>880124382</OrganizationNumber>
              <CompanyName>COVENT GARDEN AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners>SIMEN FRITZ MØRK</CompanyOwners>
              <ContactPersonName>Simen Fritz Mørk</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray5>
            <TenantArray6>
              <OrganizationNumber>983929753</OrganizationNumber>
              <CompanyName>BJERTNES AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners>KRISTIN ENGH,LISBETH ENGH,ELSE ENGH</CompanyOwners>
              <ContactPersonName>Jon Atle Kalleberg</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray6>
            <TenantArray7>
              <OrganizationNumber>988439045</OrganizationNumber>
              <CompanyName>LGF PACKAGING NORWAY AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners>TETRAX AB</CompanyOwners>
              <ContactPersonName>Conny Evert Grimling</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray7>
            <TenantArray8>
              <OrganizationNumber>971594241</OrganizationNumber>
              <CompanyName>VISITOR SYSTEMS AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners>JACK NORMANN HOFF</CompanyOwners>
              <ContactPersonName>Bård Bjørnson</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray8>
            <TenantArray9>
              <OrganizationNumber>970967583</OrganizationNumber>
              <CompanyName>RENAS BEDRIFT AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners>DAG-ARNE SÆTHER</CompanyOwners>
              <ContactPersonName>Dag-Arne Sæther</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray9>
            <TenantArray10>
              <OrganizationNumber>915469418</OrganizationNumber>
              <CompanyName>MESTERALLIANSEN AS</CompanyName>
              <TenantAddress attr0="StringArray" isNull="false">
                <StringArray0>Hvamsvingen 11,2013 Skjetten</StringArray0>
              </TenantAddress>
              <ConnectedBuildingId>0</ConnectedBuildingId>
              <TenantCompanyId>0</TenantCompanyId>
              <CompanyOwners isNull="false" />
              <ContactPersonName>Merete Nordli</ContactPersonName>
              <ContactPersonPhone isNull="true" />
              <ContactPersonEmail isNull="true" />
              <ConnectedDate>1/1/0001 12:00:00 AM</ConnectedDate>
              <UpdatedDate>1/1/0001 12:00:00 AM</UpdatedDate>
              <IsValidated isNull="true" />
              <Status>False</Status>
            </TenantArray10>
          </TenantArray>
          <PropertyOwners isNull="true" />
          <PlantId>7035</PlantId>
          <PlantName>Hvamsvingen, 2013 SKJETTEN - 6889913</PlantName>
          <CreatedTime>2/9/2018 6:23:10 PM</CreatedTime>
        </PlantArray0>
      </PlantArray>
    </LookupPropertyByAddressOutput>
  </MethodParameters>
</LookupPropertyByAddress2>

Exceptions

Error CodeDescription
101Postal number does not exist in the system
102The street address cannot be null or empty
123An exception occured while processing your request 
138applicationName length has exceeded the maximum character limit allowed (10) 
139Current version of Boligmappa does not support these type of properties (aksje/obligasjonsleiligheter)  
146The applicationName is not set
212Invalid ZipCode
397An error occurred while retreiving data from third party company search services
108Input parameters contain invalid or null data (disableMetaData = false and disableOwnerInfo = true )