Skip to content

Retrieve all contacts

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

GET /offer/v1.0/user/{username}/contact

Supported media types:
XML
JSON

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

Example:

https://rest.immobilienscout24.de/restapi/api/offer/v1.0/user/999999/contact

hands out a list of all contact addresses of an ImmobilienScout24 user with the username"999999".

Response

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>
    <secondaryEmail>secondary-email@example.com</secondaryEmail>
    <officeHours>Von 11:30 bis 12:00, dabei eine halbe Stunde Pause, field is no longer 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",
               "secondaryEmail" : "secondary-email@example.com",
               "officeHours" : "Von  11:30 bis 12:00, dabei eine halbe Stunde Pause, field is no longer 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"
           }
        ]
   }
}