Skip to content

Retrieve a Real Estate

This method provide a real estate object by a specific Id.

GET /offer/v1.0/user/{username}/realestate/{id} or .../ext-{externalId}

Supported media types:
XML
JSON

Request

Path Parameters

PARAMETER DESCRIPTION
Username the username which the user uses for logging in to www.immobilienscout24
me "me" can be used instead of the username, when the user is logged in by 3-legged oauth
id the unique scout object ID, which is being created by POST REALESTATE automatically
external-id can be used instead of the scout object ID. it is the customer-defined ID of the real estate, must be unique per user

Query Parameters

If usenewenergysourceenev2014values=true: New param since 20.08.2014. Due to downward compatibility you can see the new energySourceEnev2014 values:

PARAMETER VALUE
energySourceEnev2014 BIO_ENERGY, WIND_ENERGY, HYDRO_ENERGY, ENVIRONMENTAL_THERMAL_ENERGY, COMBINED_HEAT_AND_POWER_FOSSIL_FUELS, COMBINED_HEAT_AND_POWER_RENEWABLE_ENERGY, COMBINED_HEAT_AND_POWER_REGENERATIVE_ENERGY, COMBINED_HEAT_AND_POWER_BIO_ENERGY

Response

XML:

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<realestates:houseBuy xmlns:ns2="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:realestates="http://rest.immobilienscout24.de/schema/offer/realestates/1.0" id="74719707">
    <externalId>441</externalId>
    <title>house buy and project</title>
    <creationDate>2014-08-12T11:26:14.000+02:00</creationDate>
    <lastModificationDate>2014-08-12T11:30:37.000+02:00</lastModificationDate>
    <address>
        <street>andreasstr</street>
        <houseNumber>10</houseNumber>
        <postcode>10243</postcode>
        <city>berlin</city>
        <wgs84Coordinate>
            <latitude>52.51245</latitude>
            <longitude>13.43134</longitude>
        </wgs84Coordinate>
        <geoHierarchy>
            <continent>
                <geoCodeId>1</geoCodeId>
                <fullGeoCodeId>1</fullGeoCodeId>
            </continent>
            <country>
                <geoCodeId>276</geoCodeId>
                <fullGeoCodeId>1276</fullGeoCodeId>
            </country>
            <region>
                <geoCodeId>3</geoCodeId>
                <fullGeoCodeId>1276003</fullGeoCodeId>
            </region>
            <city>
                <geoCodeId>1</geoCodeId>
                <fullGeoCodeId>1276003001</fullGeoCodeId>
            </city>
            <quarter>
                <geoCodeId>17</geoCodeId>
                <fullGeoCodeId>1276003001017</fullGeoCodeId>
            </quarter>
            <neighbourhood>
                <geoCodeId>11000000002348</geoCodeId>
            </neighbourhood>
        </geoHierarchy>
    </address>
    <apiSearchData>
        <searchField1>searchApiField1</searchField1>
        <searchField2>searchApiField2</searchField2>
        <searchField3>searchApiField3</searchField3>
    </apiSearchData>
    <realEstateState>ACTIVE</realEstateState>
    <groupNumber>500</groupNumber>
    <descriptionNote>Objektbeschreibung</descriptionNote>
    <furnishingNote>Ausstattung </furnishingNote>
    <locationNote>Lage</locationNote>
    <otherNote>Sonstiges </otherNote>
    <attachments xlink:href="http://devrst03.rz.is/restapi/api/offer/v1.0/user/me/realestate/74719707/attachment"/>
    <showAddress>true</showAddress>
    <contact id="53323004"/>
    <common:publishChannels>
        <publishChannel id="10000" title="ImmobilienScout24"/>
        <publishChannel id="10001" title="Homepage"/>
    </common:publishChannels>
    <lodgerFlat>YES</lodgerFlat>
    <constructionPhase>PROJECTED</constructionPhase>
    <buildingType>SINGLE_FAMILY_HOUSE</buildingType>
    <energyCertificate>
        <energyCertificateAvailability>AVAILABLE</energyCertificateAvailability>
        <energyCertificateCreationDate>BEFORE_01_MAY_2014</energyCertificateCreationDate>
    </energyCertificate>
    <cellar>YES</cellar>
    <handicappedAccessible>YES</handicappedAccessible>
    <numberOfParkingSpaces>2</numberOfParkingSpaces>
    <condition>FIRST_TIME_USE_AFTER_REFURBISHMENT</condition>
    <lastRefurbishment>2002</lastRefurbishment>
    <interiorQuality>SOPHISTICATED</interiorQuality>
    <constructionYear>1999</constructionYear>
    <freeFrom>sofort</freeFrom>
    <heatingType>SELF_CONTAINED_CENTRAL_HEATING</heatingType>
    <heatingTypeEnev2014>SELF_CONTAINED_CENTRAL_HEATING</heatingTypeEnev2014>
    <energySourcesEnev2014>
        <energySourceEnev2014>SOLAR_HEATING</energySourceEnev2014>
        <energySourceEnev2014>WIND_ENERGY</energySourceEnev2014>
        <energySourceEnev2014>GEOTHERMAL</energySourceEnev2014>
        <energySourceEnev2014>COMBINED_HEAT_AND_POWER_BIO_ENERGY</energySourceEnev2014>
    </energySourcesEnev2014>
    <buildingEnergyRatingType>ENERGY_REQUIRED</buildingEnergyRatingType>
    <thermalCharacteristic>174</thermalCharacteristic>
    <energyConsumptionContainsWarmWater>NOT_APPLICABLE</energyConsumptionContainsWarmWater>
    <numberOfFloors>1</numberOfFloors>
    <usableFloorSpace>100.00</usableFloorSpace>
    <numberOfBedRooms>2</numberOfBedRooms>
    <numberOfBathRooms>2</numberOfBathRooms>
    <guestToilet>YES</guestToilet>
    <parkingSpaceType>OUTSIDE</parkingSpaceType>
    <rented>YES</rented>
    <rentalIncome>522.00</rentalIncome>
    <listed>YES</listed>
    <parkingSpacePrice>1500.00</parkingSpacePrice>
    <summerResidencePractical>YES</summerResidencePractical>
    <price>
        <value>250000.00</value>
        <currency>EUR</currency>
        <marketingType>PURCHASE</marketingType>
        <priceIntervalType>ONE_TIME_CHARGE</priceIntervalType>
    </price>
    <livingSpace>140.00</livingSpace>
    <plotArea>500.00</plotArea>
    <numberOfRooms>4</numberOfRooms>
    <energyPerformanceCertificate>true</energyPerformanceCertificate>
    <courtage>
        <hasCourtage>YES</hasCourtage>
        <courtage>Provisionshöhe </courtage>
        <courtageNote>Provisionshinweis</courtageNote>
    </courtage>
</realestates:houseBuy>

JSON:

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
{
       "realestates.houseBuy":
       {
           "@id": "74719707",
           "externalId": "441",
           "title": "house buy and project 2",
           "creationDate": "2014-08-12T11:26:14.000+02:00",
           "lastModificationDate": "2014-08-12T11:30:37.000+02:00",
           "address":
           {
               "street": "andreasstr",
               "houseNumber": "10",
               "postcode": "10243",
               "city": "berlin",
               "wgs84Coordinate":
               {
                   "latitude": 52.51245,
                   "longitude": 13.43134
               },
               "geoHierarchy":
               {
                   "continent":
                   {
                       "geoCodeId": 1,
                       "fullGeoCodeId": "1"
                   },
                   "country":
                   {
                       "geoCodeId": 276,
                       "fullGeoCodeId": "1276"
                   },
                   "region":
                   {
                       "geoCodeId": 3,
                       "fullGeoCodeId": "1276003"
                   },
                   "city":
                   {
                       "geoCodeId": 1,
                       "fullGeoCodeId": "1276003001"
                   },
                   "quarter":
                   {
                       "geoCodeId": 17,
                       "fullGeoCodeId": "1276003001017"
                   },
                   "neighbourhood":
                   {
                       "geoCodeId": 11000000002348
                   }
               }
           },
           "apiSearchData":
           {
               "searchField1": "searchApiField1",
               "searchField2": "searchApiField2",
               "searchField3": "searchApiField3"
           },
           "realEstateState": "ACTIVE",
           "groupNumber": 500,
           "descriptionNote": "Objektbeschreibung",
           "furnishingNote": "Ausstattung ",
           "locationNote": "Lage",
           "otherNote": "Sonstiges ",
           "attachments":
           [
               {
                   "@xlink.href": "http://devrst03.rz.is/restapi/api/offer/v1.0/user/me/realestate/74719707/attachment"
               }
           ],
           "showAddress": "true",
           "contact":
           {
               "@id": "53323004"
           },
           "common.publishChannels":
           [
               {
                   "publishChannel":
                   [
                       {
                           "@id": "10000",
                           "@title": "ImmobilienScout24"
                       },
                       {
                           "@id": "10001",
                           "@title": "Homepage"
                       }
                   ]
               }
           ],
           "lodgerFlat": "YES",
           "constructionPhase": "PROJECTED",
           "buildingType": "SINGLE_FAMILY_HOUSE",
           "energyCertificate":
           {
               "energyCertificateAvailability": "AVAILABLE",
               "energyCertificateCreationDate": "BEFORE_01_MAY_2014"
           },
           "cellar": "YES",
           "handicappedAccessible": "YES",
           "numberOfParkingSpaces": 2,
           "condition": "FIRST_TIME_USE_AFTER_REFURBISHMENT",
           "lastRefurbishment": 2002,
           "interiorQuality": "SOPHISTICATED",
           "constructionYear": 1999,
           "freeFrom": "sofort",
           "heatingType": "SELF_CONTAINED_CENTRAL_HEATING",
           "heatingTypeEnev2014": "SELF_CONTAINED_CENTRAL_HEATING",
           "energySourcesEnev2014":
           {
               "energySourceEnev2014":
               [
                   "SOLAR_HEATING",
                   "WIND_ENERGY",
                   "GEOTHERMAL",
                   "COMBINED_HEAT_AND_POWER_BIO_ENERGY"
               ]
           },
           "buildingEnergyRatingType": "ENERGY_REQUIRED",
           "thermalCharacteristic": 174,
           "energyConsumptionContainsWarmWater": "NOT_APPLICABLE",
           "numberOfFloors": 1,
           "usableFloorSpace": 100,
           "numberOfBedRooms": 2,
           "numberOfBathRooms": 2,
           "guestToilet": "YES",
           "parkingSpaceType": "OUTSIDE",
           "rented": "YES",
           "rentalIncome": 522,
           "listed": "YES",
           "parkingSpacePrice": 1500,
           "summerResidencePractical": "YES",
           "price":
           {
               "value": 250000,
               "currency": "EUR",
               "marketingType": "PURCHASE",
               "priceIntervalType": "ONE_TIME_CHARGE"
           },
           "livingSpace": 140,
           "plotArea": 500,
           "numberOfRooms": 4,
           "energyPerformanceCertificate": "true",
           "courtage":
           {
               "hasCourtage": "YES",
               "courtage": "Provisionshöhe ",
               "courtageNote": "Provisionshinweis"
           }
       }
    }