Master Contact Service

Updated on 08 Jan 2026
1 Minute to read

Print
Share
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback!

Enhancing your Data Security

To provide the most secure environment for your business, WineDirect is moving all web services to a more secure protocol (HTTPS) effective February 16, 2026.

Starting on February 16, 2026 all API calls not using HTTPS will be redirected to the HTTPS version of the endpoint and return an HTTP 302 Found response code. This may break some integrations if redirects cannot be handled by your current implementation. To avoid this, please update your API calls to use only HTTPS endpoints or reach out to your Web Developer or Integration Partner to confirm that your current connections are compatible with HTTPS.

Please note the Master Contact Service is only available for Enterprise clients.

WSDL:

https://webservices.vin65.com/V300/MasterContactService.cfc?wsdl

Australian URL:

https://webservices.aus.vin65.com/V300/MasterContactService.cfc?wsdl

Methods:

SearchMasterContacts()
Use this method to search across master contacts.

SearchMasterContacts()

Part Of: Master Contact Webservice 3.0

WSDL:

https://webservices.vin65.com/V300/MasterContactService.cfc?wsdl

Australian URL:

https://webservices.aus.vin65.com/V300/MasterContactService.cfc?wsdl

Description:

Use the SearchMasterContacts() function to get a single master contact or a list of master contacts using the search options listed below. Required fields are indicated by a '*'

Parameters:

Attribute	Data Type	Default	Description
MasterContactID	UUID		UUID of the Vin65 Master Contact
ContactID	UUID		UUID of the Vin65 Contact
FirstName	String 50
LastName	String 50
Company	String 255
City	String 50
StateCode	String 50
Phone	String 50
Email	String 100
DateModifiedFrom	DateTime
DateModifiedTo	DateTime
MaxRows	Integer	100
Page	Integer	1

Sample Request:

<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<soap:Body>
  <SearchMasterContacts>
    <Request>
      <Security>
        <Username>//Your Username//</Username>
        <Password>//Your Password//</Password>
      </Security>
      <MasterContactID></MasterContactID>
      <ContactID></ContactID>
      <FirstName></FirstName>
      <LastName></LastName>
      <Company></Company>
      <City></City>
      <StateCode></StateCode>
      <Phone></Phone>
      <Email></Email>
      <DateModifiedFrom>2011-01-01T12:21:43</DateModifiedFrom>
      <DateModifiedTo>2011-09-12T12:21:43</DateModifiedTo>
      <MaxRows>100</MaxRows>
      <Page>1</Page> 
    </Request>
  </SearchMasterContacts>
</soap:Body> 
</soap:Envelope>

Sample Response:

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapen v="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
  <SearchMasterContactsResponse>
    <SearchMasterContactsReturn>
      <Errors></Errors>
      <IsSuccessful>true</IsSuccessful>
      <MasterContacts>
        <MasterContact>
          <Address>123 Mardel Avenue</Address>
          <Address2></Address2>
          <BirthDate>{ts '1987-08-16 00:00:00'}</BirthDate>
          <City>Saint Louis</City>
          <Company></Company>
          <CountryCode></CountryCode>
          <DateAdded>2011-04-21T19:14:38.610Z</DateAdded>
          <DateModified>2011-04-21T19:14:38.610Z</DateModified>
          <Email>alexsmith@gmail.com</Email>
          <FirstName>Alex</FirstName>
          <LastName>Smith</LastName>
          <MasterContactID>34e424dc-01c0-4309-60ef-8784a41cb758</MasterContactID>
          <Phone>314.555.1212</Phone>
          <PrimaryContactID>f8c4fecc-d465-b772-ce4d-db1dc37245a0</PrimaryContactID>
          <StateCode>MO</StateCode>
          <ZipCode>63109</ZipCode>
        </MasterContact>
        <MasterContact>
          <Address>310 Arch st</Address>
          <Address2></Address2>
          <BirthDate>{ts '1966-08-22 00:00:00'}</BirthDate>
          <City>Springhill</City>
          <Company></Company>
          <CountryCode></CountryCode>
          <DateAdded>2011-04-21T19:16:56.647Z</DateAdded>
          <DateModified>2011-04-21T19:16:56.647Z</DateModified>
          <Email>Alexa@yahoo.com</Email>
          <FirstName>Alexa</FirstName>
          <LastName>Smith</LastName>
          <MasterContactID>34f934de-b25f-767f-dc89-507edf0b7e45</MasterContactID>
          <Phone>252-777-5555</Phone>
          <PrimaryContactID>7491dca3-c2cc-968c-ceaf-f8921c82a421</PrimaryContactID>
          <StateCode>NC</StateCode>
          <ZipCode>27948</ZipCode>
        </MasterContact>
      </MasterContacts>
      <RecordCount>2</RecordCount>
    </SearchMasterContactsReturn>
  </SearchMasterContactsResponse>
</soapenv:Body>
</soapenv:Envelope>

Was this article helpful?

What's Next

List Builder Service