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:
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:

<common:messages xmlns:ns2="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:xlink="http://www.w3.org/1999/xlink">
   <message>
      <messageCode>MESSAGE_RESOURCE_DELETED</messageCode>
      <message>Resource [premiumplacement] with id [] has been deleted.</message>
   </message>
</common:messages>

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

<common:messages xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ns3="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0">
   <message>
      <messageCode>ERROR_RESOURCE_VALIDATION</messageCode>
      <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>
   </message>
</common:messages>