Assign Real Estate to a project

This method adds a real estate object to a project. It is also possible to add a list of objects

POST /offer/v1.0/user/username/realestateproject/{realEstateProjectId}/realestateprojectentry

Supported media types:
XML
JSON

Notes:

  • You can use your own object ID (externalId) by POSTing a real estate object to a project
  • Use instead of in your body, so you don't need the prefix "ext-"
  • ATTENTION: At the moment it's necessary to publish the realEstate before adding it to the realEstateProject because it's impossible to publish unpublished realEstates in the realEstateProject. If you deaktivate a realEstates in the realEstateProject and publish it again some time later you must delete that object from that project, publish it via vario contingent and add it than again to that realEstateProject.

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
realestateprojectid the unique project ID, generated by IS24 when posting a real estate project

XML:

<realestateproject:realEstateProjectEntries xmlns:realestateproject="http://rest.immobilienscout24.de/schema/offer/realestateproject/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ns4="http://rest.immobilienscout24.de/schema/platform/gis/1.0">
   <realEstateProjectEntry>
      <realEstateId>123456</realEstateId>
   </realEstateProjectEntry>
   <realEstateProjectEntry>
      <realEstateExtneralId>myRealEstate</realEstateExternalId>
   </realEstateProjectEntry>
</realestateproject:realEstateProjectEntries>

Response

XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<realestateproject:realEstateProjectEntries xmlns:realestateproject="http://rest.immobilienscout24.de/schema/offer/realestateproject/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ns4="http://rest.immobilienscout24.de/schema/platform/gis/1.0">
    <realEstateProjectEntry>
        <messageCode>MESSAGE_RESOURCE_CREATED</messageCode>
        <message>real estate with id 123456 was added to project 987</message>
        <realEstateId>62455263</realEstateId>
    </realEstateProjectEntry>
    <realEstateProjectEntry>
        <messageCode>MESSAGE_RESOURCE_CREATED</messageCode>
        <message>real estate with external id myRealEstate was added to project 987</message>
        <realEstateExternalId>myRealEstate</realEstateExternalId>
    </realEstateProjectEntry>
</realestateproject:realEstateProjectEntries>