Skip to content

Retrieve an OnTop

This method provides a way to get information about the OnTop Placement of a real estate.

GET /commercial-offer/v1.0/user/{username or me}/realestate/{id or externalId with prefix "ext-"}

Supported media types:
XML

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

Example

https://rest.immobilienscout24.de/restapi/api/commercial-offer/v1.0/user/me/realestate/53483572

Response

Example response I: the requested listing has a already a businessplacement with prio option placed. Therefore only an upgrade to firstplacement is possible. As the firstplacement is exlusively once available for the building of the listing, this will get market by the attribute "available". As in this case the firstplacement is not available, the reservation option is also returned, as it is possible to do a reservation for the upgrade.

 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
<ontopplacement:ontopplacements
xmlns:ontopplacement=
"http://rest.immobilienscout24.de/schema/commercial-offer/ontopplacement/1.0"
xmlns:xlink="http://www.w3.org/1999/xlink">
   <ontopplacement realestateid="53483572">
      <currentproduct name="businessplacement">
        <options>
            <option name="priority" />
        </options>
        <servicePeriod>
         <dateFrom>2014-01-28T13:17:10.000+01:00</dateFrom>
         <dateTo>2014-02-28T13:17:10.000+01:00</dateTo>
        </servicePeriod>
      </currentproduct>
      <productcatalog>
        <product name="firstplacement" available="false">
            <points>500</points>
            <options>
              <option name="priority">
                <points>75</points>
              </option>
              <option name="enqueue">            
                <availableDate>2014-05-06</availableDate>
                <points>30</points>
              </option>
            </options>   
        </product>
      </productcatalog>
      <remainingBalance>500</remainingBalance>
   </ontopplacement>
</ontopplacement:ontopplacements>

Example response II: the requested listing has no OnTop placement set. Therefore all OnTop placements are available. As the first placement is available, the reservation option is not given. Also a prio option on the basic listing is possible to set.

 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
<ontopplacement:ontopplacements
xmlns:ontopplacement=
"http://rest.immobilienscout24.de/schema/commercial-offer/ontopplacement/1.0"
xmlns:xlink="http://www.w3.org/1999/xlink">
   <ontopplacement realestateid="53483572">
      <currentproduct name="basic" />
      <productcatalog>
        <product name="firstplacement" available="true">
            <points>500</points>
            <options>
              <option name="priority">
                <points>75</points>
              </option>
            </options>   
        </product>
        <product name="businessplacement">
            <points>300</points>
            <options>
              <option name="priority">
                <points>50</points>
              </option>
            </options>   
        </product>
        <product name="basic">
            <points>0</points>
            <options>
              <option name="priority">
                <points>35</points>
              </option>
           </options>
        </product>
      </productcatalog>
      <remainingBalance>500</remainingBalance>
   </ontopplacement>
</ontopplacement:ontopplacements>

Example response III: the requested listing has a already a firstplacement with prio option placed and two reservations. Therefore only an upgrade to firstplacement is possible. As the firstplacement is exlusively once available for the building of the listing, this will get market by the attribute "available". As in this case the firstplacement is not available, the reservation option is also returned, as it is possible to do another reservation.

 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
<ontopplacement:ontopplacements
xmlns:ontopplacement=
"http://rest.immobilienscout24.de/schema/commercial-offer/ontopplacement/1.0"
xmlns:xlink="http://www.w3.org/1999/xlink">
   <ontopplacement realestateid="53483572">
      <currentproduct name="firstplacement">
        <options>
            <option name="priority" />
                <option name="enqueue">            
                  <availableDate>2014-05-06</availableDate>
                </option>
                <option name="enqueue">            
                  <availableDate>2014-06-06</availableDate>
                </option>
        </options>
        <servicePeriod>
         <dateFrom>2014-01-28T13:17:10.000+01:00</dateFrom>
         <dateTo>2014-02-28T13:17:10.000+01:00</dateTo>
        </servicePeriod>
      </currentproduct>
      <productcatalog>
        <product name="firstplacement" available="false">
            <points>0</points>
            <options>
              <option name="priority">
                <points>0</points>
              </option>
              <option name="enqueue">            
                <availableDate>2014-07-06</availableDate>
                <points>30</points>
              </option>
            </options>   
        </product>
      </productcatalog>
      <remainingBalance>500</remainingBalance>
   </ontopplacement>
</ontopplacement:ontopplacements>

Example response IV: the requested listing has a already a businessplacement with prio option placed and one reservation for the first upgrade. As the firstplacement is exlusively once available for the building of the listing, this will get market by the attribute "available". As in this case the firstplacement is not available, the reservation option is also returned, as it is possible to do another reservation.

 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
<ontopplacement:ontopplacements
xmlns:ontopplacement="http://rest.immobilienscout24.de/schema/commercial-offer/ontopplacement/1.0"
xmlns:xlink="http://www.w3.org/1999/xlink">
    <ontopplacement realestateid="70663112">
        <currentproduct name="businessplacement">
            <options>
                <option name="priority"/>
                <option name="enqueued">
                    <availableDate>2018-08-04</availableDate>
                </option>
            </options>
            <servicePeriod>
                <dateFrom>2018-06-26T11:31:14.933205+02:00</dateFrom>
                <dateTo>2018-07-26T11:31:14.933205+02:00</dateTo>
            </servicePeriod>
        </currentproduct>
        <productcatalog>
            <product name="firstplacement" available="false">
                <points>0</points>
                <options>
                    <option name="priority">
                        <points>0</points>
                    </option>
                    <option name="enqueue">
                        <points>20</points>
                    </option>
                </options>
            </product>
        </productcatalog>
        <remainingBalance>15160</remainingBalance>
    </ontopplacement>
</ontopplacement:ontopplacements>