DELETEbyID RealEstateProjectEntry

This methods deletes a real estate project entry (real estate object) from a real estate project.

https://rest.immobilienscout24.de/restapi/api/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/realestateprojectentry/ {realEstateId} or ext-{realEstateExternalId}

  • It's impossible to remove published realEstates from the realEstateProject. Please deactivate the realEstate previously! 

Supported media types

  • XML (Accept: application/xml)
  • JSON (Accept: application/json)

Authorization requirements

A System Key and an authenticated user are required for this operation:

Please use a secure connection (https) for this operation.

Request

Path Parameters

  • Username: the username which the user uses for logging in to www.immobilienscout24.

  • Username: "me" can be used instead of the username, when the user is logged in by 3-legged oauth.
  • realestateprojectid: the unique project ID, generated by IS24 when posting a real estate project
  • realestateId or realEstateExternalId: the ID of the real estate object (real estate project entry). Use scout ID oder your own object ID.

Query Parameters

  • none

Response

The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.
Error responses as well as other simple message responses are described in detail within the common message responses.

  • Status 200 OK
  • The requested operation was successful.

Header

No special headers.

Body

XML

<?xml version="1.0" encoding="UTF-8"?>
<common:messages
    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 [real estate from project 987] with id [123456] has been deleted.</message>
        <id>123456</id>
    </message>
</common:messages>

JSON

{
    "common:messages": {
        "@xmlns:common": "http://rest.immobilienscout24.de/schema/common/1.0", 
        "@xmlns:xlink": "http://www.w3.org/1999/xlink", 
        "message": {
            "messageCode": "MESSAGE_RESOURCE_DELETED", 
            "message": "Resource [real estate from project 987] with id [123456] has been deleted.", 
            "id": "123456"
        }
    }
}