---
title: "Master Contact Service"
slug: "master-contact-service"
updated: 2024-04-08T16:14:48Z
published: 2024-04-08T16:14:48Z
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

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>
```