Contact

Contact/GetAll

This method hands out all contact adresses of an ImmobilienScout24 user as a list, these contacts can be accessed by the url you've got in the response.

https://rest.immobilienscout24.de/restapi/api/offer/v1.0/user/{username}/contact/

 

Example: https://rest.immobilienscout24.de/restapi/api/offer/v1.0/user/999999/contact hands out a list of all contact adresses of an ImmobilienScout24 user with the username"999999".

 

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 oder "me"

 

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

  • none

 

note: You need a special permission to get the email-adresse-field. If you miss that element write us a email or post that problem in our googlegroup!

 

Body

 

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<common:realtorContactDetailsList xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:ns4="http://rest.immobilienscout24.de/schema/platform/gis/1.0">
  <realtorContactDetails id="74499987">
    <email>max.mustermann@immobilienscout24.de</email>
    <salutation>MALE</salutation>
    <firstname>Max</firstname>
    <lastname>Mustermann</lastname>
    <faxNumberCountryCode>+49</faxNumberCountryCode>
    <faxNumberAreaCode>30</faxNumberAreaCode>
    <faxNumberSubscriber>243010001</faxNumberSubscriber>
    <phoneNumberCountryCode>+49</phoneNumberCountryCode>
    <phoneNumberAreaCode>30</phoneNumberAreaCode>
    <phoneNumberSubscriber>243010001</phoneNumberSubscriber>
    <cellPhoneNumberCountryCode>+49</cellPhoneNumberCountryCode>
    <cellPhoneNumberAreaCode>179</cellPhoneNumberAreaCode>
    <cellPhoneNumberSubscriber>24301000 1</cellPhoneNumberSubscriber>
    <address>
        <street>Andreasstr.</street>
        <houseNumber>10</houseNumber>
        <postcode>10243</postcode>
        <city>Berlin</city>
    </address>
    <countryCode>DEU</countryCode>
    <title>Master</title>
    <additionName>HuiBuh</additionName>
    <homepageUrl>http://www.immobilienscout24.de</homepageUrl>    
    <position>position oder taetigkeit im unternehmen</position>
    <officeHours>Von 11:30 bis 12:00, dabei eine halbe Stunde Pause, field is no more used or visible in the is24 website</officeHours>   
    <defaultContact>false</defaultContact>
    <localPartnerContact>false</localPartnerContact>
    <businessCardContact>false</businessCardContact>
    <realEstateReferenceCount>2</realEstateReferenceCount>
    <externalId>a-001</externalId>
    <showOnProfilePage>true</showOnProfilePage>      
  </realtorContactDetails>
  <realtorContactDetails id="74502139">
        <email>minmalset@is24.de</email>
        <salutation>NO_SALUTATION</salutation>
        <lastname>minimalset</lastname>
        <countryCode>GNQ</countryCode>
        <defaultContact>false</defaultContact>
        <localPartnerContact>false</localPartnerContact>
        <businessCardContact>false</businessCardContact>
        <realEstateReferenceCount>0</realEstateReferenceCount>
        <showOnProfilePage>false</showOnProfilePage>
  </realtorContactDetails>
</common:realtorContactDetailsList>


JSON

{
   "common.realtorContactDetailsList":
   {
       "realtorContactDetails":
       [
           
            {
               "@id": "74281229",
               "email": "kk@is24.de",
               "salutation": "MALE",
               "firstname": "Max",
               "lastname": "Mustermann",
               "faxNumberCountryCode": "+49",
               "faxNumberAreaCode": "30",
               "faxNumberSubscriber": "2430111",
               "faxNumber": "+49 30 2430111",
               "phoneNumberCountryCode": "+49",
               "phoneNumberAreaCode": "30",
               "phoneNumberSubscriber": "2430122",
               "phoneNumber": "+49 30 2430122",
               "cellPhoneNumberCountryCode": "+49",
               "cellPhoneNumberAreaCode": "172",
               "cellPhoneNumberSubscriber": "2430133",
               "cellPhoneNumber": "+49 172 2430133",
               "address":
               {
                   "street": "Andreasstr.",
                   "houseNumber": "10",
                   "postcode": "10243",
                   "city": "Berlin"
               },
               "countryCode": "DEU",
               "title": "Doktor",
               "additionName": "int.ZusatzName",
               "homepageUrl": "http://www.immobilienscout24.de",
               "position": "taetigkeit oder position im unternehmen",
               "officeHours" : "Von  11:30 bis 12:00, dabei eine halbe Stunde Pause, field is no more used or visible in the is24 website" ,
               "defaultContact": "false",
               "localPartnerContact": "false",
               "businessCardContact": "false",
               "realEstateReferenceCount": 1,
               "showOnProfilePage": "true"
           },
            {
               "@id": "74502139",
               "email": "minmalset@is24.de",
               "salutation": "NO_SALUTATION",
               "lastname": "minimalset",
               "countryCode": "GNQ",
               "defaultContact": "false",
               "localPartnerContact": "false",
               "businessCardContact": "false",
               "realEstateReferenceCount": 0,
               "showOnProfilePage": "false"
           }
        ]
   }
}