---
title: "Master Contact Service"
slug: "master-contact-service"
updated: 2026-01-08T20:58:04Z
published: 2026-01-08T20:58:04Z
canonical: "docs.winedirect.com/master-contact-service"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.winedirect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Master Contact Service

Enhancing your Data SecurityTo 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](https://webservices.vin65.com/V300/MasterContactService.cfc?wsdl)

#### Australian URL:

[https://webservices.aus.vin65.com/V300/MasterContactService.cfc?wsdl](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](https://webservices.vin65.com/V300/MasterContactService.cfc?wsdl)

#### Australian URL:

[https://webservices.aus.vin65.com/V300/MasterContactService.cfc?wsdl](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>
```