Skip to content

Delete an OnTop placement

This method provides a method to delete a single OnTop Placement. 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 every 24 hours.

DELETE /offer/v1.0/user/{username or me}/realestate/{id or externalid}/{ontop placement}

Supported media types:

Possible OnTop Placements:

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


Path Parameters

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)



<common:messages xmlns:ns2="" xmlns:common="" xmlns:xlink="">
      <message>Resource [premiumplacement] with id [] has been deleted.</message>

or 412 (if you try to delete the connection between real estate and premium placement within 24h)

<common:messages xmlns:xlink="" xmlns:ns3="" xmlns:common="">
      <message>Error while validating input for the resource. [MESSAGE: premiumplacement for realestate with id='53483572' can not be deleted before 2014-01-29T13:17:10.000+01:00]</message>