Skip to content

Retrieve a Real Estate project

This method hands out a building project according to the requested Id

Note

The fields that will be returned depend on the product booked for the real estate project (see the OPTIONS call).

GET /offer/v1.0/user/{username}/realestateproject/{realestateprojectid}

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 1.0
realestateprojectid the unique project ID, generated by IS24 when posting a real estate project

Successful 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
<ns4:realEstateProject xmlns:ns4="http://rest.immobilienscout24.de/schema/offer/realestateproject/1.0" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:gis="http://rest.immobilienscout24.de/schema/platform/gis/1.0" id="122160">
    <name>New Luxury Project</name>
    <title>New Luxury Project with garden view and smart home facilities</title>
    <price>
        <minimal>10000.00</minimal>
        <maximal>40000.00</maximal>
    </price>
    <space>
        <minimal>100.00</minimal>
        <maximal>200.00</maximal>
    </space>
    <minPriceProQm>134.00</minPriceProQm>
    <numberOfHousingUnit>50</numberOfHousingUnit>
    <interiorQuality>LUXURY</interiorQuality>
    <freeFrom>01.01.2021</freeFrom>
    <address>
        <street>Andreasstr.</street>
        <houseNumber>10</houseNumber>
        <postcode>10245</postcode>
        <city>Berlin</city>
    </address>
    <homepageUrl>http://www.myhompage.com</homepageUrl>
    <extProjectUrl>http://www.myProject-url.com</extProjectUrl>
    <description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
    </description>
    <numberOfHousingUnitsDetails>
        <apartmentCount>30</apartmentCount>
        <houseCount>10</houseCount>
        <commercialCount>10</commercialCount>
    </numberOfHousingUnitsDetails>
    <interiorCharacteristics>
        <InteriorCharacteristic>smart home</InteriorCharacteristic>
        <InteriorCharacteristic>fireplace</InteriorCharacteristic>
        <InteriorCharacteristic>garden</InteriorCharacteristic>
        <InteriorCharacteristic>balcony</InteriorCharacteristic>
        <InteriorCharacteristic>terrace</InteriorCharacteristic>
        <InteriorCharacteristic>hard wood floors</InteriorCharacteristic>
    </interiorCharacteristics>
    <interiorQualityDescription>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</locationDescription>
    <rooms>
        <minimal>1.0</minimal>
        <maximal>4.0</maximal>
    </rooms>
    <companyName>Company Name</companyName>
    <contact>
        <lastName>Mustermann</lastName>
        <firstName>Max</firstName>
        <email>max.mustermann@example.com</email>
        <phone>+49 30 243011100</phone>
    </contact>
</ns4:realEstateProject>

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
{
  "realestateproject.realEstateProject":{
    "@id":"122160",
    "name":"New Luxury Project",
    "title":"New Luxury Project with garden view and smart home facilities",
    "price":{
      "minimal":10000,
      "maximal":40000
    },
    "space":{
      "minimal":100,
      "maximal":200
    },
    "minPriceProQm":134,
    "numberOfHousingUnit":50,
    "interiorQuality":"LUXURY",
    "freeFrom":"01.01.2021",
    "address":{
      "street":"Andreasstr.",
      "houseNumber":"10",
      "postcode":"10245",
      "city":"Berlin"
    },
    "homepageUrl":"http:\/\/hompage.com",
    extProjectUrl":"http:\/\/myProject-url.com",
    "description":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
    "numberOfHousingUnitsDetails":{
      "apartmentCount":30,
      "houseCount":10,
      "commercialCount":10
    },
    "interiorCharacteristics":[
      {
        "InteriorCharacteristic":[
          "smart home",
          "fireplace",
          "garden",
          "balcony",
          "terrace",
          "hard wood floors"
        ]
      }
    ]
    ,
    "interiorQualityDescription":"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
    "rooms":{
      "minimal":1,
      "maximal":4
    },
    "companyName":"Company Name",
    "contact":{
      "lastName":"Mustermann",
      "firstName":"Max",
      "email":"max.mustermann@example.com",
      "phone":"+49 30 243011100"
    }
  }
}