Skip to content

Delete many OnTop placements

This method provides a way to delete a list of OnTop Placements. This means that the connection of a certain real estate to the OnTop Placement is being deleted, not the OnTop Placement booking. This method can only be used once every 24 hours.

DELETE /offer/v1.0/user/{username or me}/{ontop placement}/list?realestateids={realestateid,ext-externalid,...}

Supported media types:
XML
JSON

Possible OnTop Placements:

  • showcaseplacement ("Schaufenster-Platzierung")
  • premiumplacement ("Premium-Platzierung")
  • topplacement ("Top-Platzierung")

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
ontop placement the type of the OnTop placement (showcaseplacement, premiumplacement or topplacement)

Response

XML: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<premiumplacement:premiumplacements xmlns:premiumplacement="http://rest.immobilienscout24.de/schema/offer/premiumplacement/1.0" xmlns:xlink="http://www.w3.org/1999/xlink">
   <premiumplacement realestateid="ext-API1414510357267">
      <messageCode>ERROR_RESOURCE_VALIDATION</messageCode>
      <message>[premiumplacement for realestate with id='75911415' can not be deleted before 2014-10-29T16:32:40.000+01:00]</message>
   </premiumplacement>
   <premiumplacement realestateid="75911415 ">
      <messageCode>MESSAGE_RESOURCE_DELETED</messageCode>
      <message>Resource [premiumplacement] has been deleted.</message>
   </premiumplacement>
</premiumplacement:premiumplacements>