Skip to content

Delete a contact

This method deletes the contact and assigns the referenced real estates to the defaul contact or to another contact.

DELETE /offer/v1.0/user/{username or me}/contact/{id or ext-externalId}

Supported media types:
XML
JSON

Notes:

  • Be careful if you want to delete the default contact! If you use the parameter assigntocontactid, the new contact will be the default contact.
  • Using externalId of old contact (path parameter) and new contact (query parameter) is possible
  • Use parameter assigntocontactid to assign real estates to another contact

Request

Path Parameters

id / externalId cannot be used at the same time.

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 generated with POST REALESTATE, automatically
externalId the contact id of the rest api client. it must be unique for a user and must contain the prefix "ext-"

Query Parameters

PARAMETER DESCRIPTION
assigntocontactid optional, but very useful
se prefix "ext-" e.g. ...?assigntocontactid=ext-hiredContact

Response

XML: 

1
2
3
4
5
6
7
<common:messages xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:ns3="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink">
   <message>
      <messageCode>MESSAGE_RESOURCE_DELETED</messageCode>
      <message>Resource [contact] with id [123456] has been deleted.</message>
      <id>123456</id>
   </message>
</common:messages>

JSON: 

1
2
3
4
5
6
7
8
9
{
    "common:messages": {
        "message": {
            "messageCode": "MESSAGE_RESOURCE_DELETED",
            "message": "Resource [contact] with id [123456] has been deleted.",
            "id": "123456"
        }
    }
}