Overview

This API call is designed to list addresses that are within the country specified and match a search string.

Search Addresses

 To search for an address;

  1. Create a SearchAddressesRequest
  2. Specify the Country ID and Search String

WSDL

https://api.emersion.com.au/Contacts.wsdl

Operation name

SearchAddresses



Business Rules

Addresses within Australia (Country ID 113) will utilise an address lookup via Australian GNAF

Addresses outside of Australia will utilise an address lookup via Google




SOAP Example

For Australia

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:SearchAddressesRequest>
         <urn:Country>113</urn:Country>
         <urn:SearchString>5/50 Creek</urn:SearchString>
      </urn:SearchAddressesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Sample Response
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:emersion:types" xmlns:ns2="urn:emersion:api">
   <SOAP-ENV:Body>
      <ns2:SearchAddressesResponse>
         <ns2:SearchAddresses>
            <ns1:SearchAddress>
               <ns1:PlaceID>GAVIC420074121</ns1:PlaceID>
               <ns1:FormattedAddress>5/50 Creek Road, Mitcham VIC 3132</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW716879329</ns1:PlaceID>
               <ns1:FormattedAddress>50/5 Lusty Street, Wolli Creek NSW 2205</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW705059889</ns1:PlaceID>
               <ns1:FormattedAddress>Lot 5, 50 Overett Avenue, Kemps Creek NSW 2178</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GAQLD155750379</ns1:PlaceID>
               <ns1:FormattedAddress>Lot 5, 50 Firewheel Road, Ringtail Creek QLD 4565</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW705063179</ns1:PlaceID>
               <ns1:FormattedAddress>Lot 5, 50 Racemosa Close, Kemps Creek NSW 2178</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW704734360</ns1:PlaceID>
               <ns1:FormattedAddress>Lot 50, 5 Stapleton Street, Falls Creek NSW 2540</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW719286189</ns1:PlaceID>
               <ns1:FormattedAddress>50/1-5 Gertrude Street, Wolli Creek NSW 2205</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW705056566</ns1:PlaceID>
               <ns1:FormattedAddress>Lot 5, 50 Watts Road, Kemps Creek NSW 2178</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW717882915</ns1:PlaceID>
               <ns1:FormattedAddress>5/42-50 South Creek Road, Collaroy NSW 2097</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>GANSW706291432</ns1:PlaceID>
               <ns1:FormattedAddress>Lot 5, 50 Punyarra Street, Werris Creek NSW 2341</ns1:FormattedAddress>
            </ns1:SearchAddress>
         </ns2:SearchAddresses>
      </ns2:SearchAddressesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

For other countries

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:SearchAddressesRequest>
         <urn:Country>257</urn:Country>
         <urn:SearchString>50 Fifth Avenue</urn:SearchString>
      </urn:SearchAddressesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Sample Response
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:emersion:types" xmlns:ns2="urn:emersion:api">
   <SOAP-ENV:Body>
      <ns2:SearchAddressesResponse>
         <ns2:SearchAddresses>
            <ns1:SearchAddress>
               <ns1:PlaceID>ChIJIR7DNewYbW0Rs7DuMKZV9WU</ns1:PlaceID>
               <ns1:FormattedAddress>50 Fifth Avenue, Enderley, Hamilton, New Zealand</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>EiY1MCBGaWZ0aCBBdmVudWUsIFRhdXJhbmdhLCBOZXcgWmVhbGFuZCIwEi4KFAoSCR1NowzF221tEZDllAZh7wATEDIqFAoSCdUDbkLF221tEZSpX_mLFBD0</ns1:PlaceID>
               <ns1:FormattedAddress>50 Fifth Avenue, Tauranga, New Zealand</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>ChIJARHGfB5HDW0RVWQzkzQmjIQ</ns1:PlaceID>
               <ns1:FormattedAddress>50 Fifth Avenue, Mount Albert, Auckland, New Zealand</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>ChIJ7egVs_DwFG0RJWLTN-uxPwk</ns1:PlaceID>
               <ns1:FormattedAddress>50 Fifth Avenue, Urenui, New Zealand</ns1:FormattedAddress>
            </ns1:SearchAddress>
            <ns1:SearchAddress>
               <ns1:PlaceID>EjA1MCBGaWZ0aCBBdmVudWUsIEF2ZW51ZXMsIFdoYW5nYXJlaSwgTmV3IFplYWxhbmQiMBIuChQKEgnr42FtHX8LbRFRdoMGYe8AExAyKhQKEgnxZrSHHX8LbRHvhEO1wboGNg</ns1:PlaceID>
               <ns1:FormattedAddress>50 Fifth Avenue, Avenues, Whangarei, New Zealand</ns1:FormattedAddress>
            </ns1:SearchAddress>
         </ns2:SearchAddresses>
      </ns2:SearchAddressesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>




Field Descriptions

All field names are case sensitive. Check enumerated values in the descriptions to confirm capitalisation and spacing. See field types for additional information..

NameDescriptionRequired?Field Type

Character

limit

Values
Country
The id or name of the countryYesString

113 or Australia (case-insensitive)

Other values available via Report > List > Reference > Country Reference Data (#1135)

SearchStringThe address being searched for - partial data acceptedYesString
L8,, 460 Bourke Street



Error Handling


Error MessageDescription
Country is requiredThe country is missing.
Country is not validCan not find the country you entered.
Search String is requiredThe search string is missing