Master Fetch '/contacts/{contactid}/master'

The Master Fetch returns a wealth of Contact Data, but not all data, pertaining to a specific contact Record.

If your purpose is to obtain Basic Contact Information, as well as Addresses, Internet Addresses, and Phone numbers associated with a specific ContactID, this method will simplify the process by cutting out a few calls. 

The Alternative approach would have you run through the following documented Get Methods.

Contact by ContactID Fetch

returns contact record by ContactID

Addresses by ContactID Fetch

returns a list of Address records for a ContactID

Phones by ContactID Fetch

returns a list of Phone records for a ContactID

Internet Addresses by ContactID Fetch

returns a list of Internet Addresses records for a ContactID


The URI '/contacts/{contactid}', when coupled with Method Type 'GET',  returns a contact record's details.

The ContactID, also often referred to as the ClientID, is the unique identifier for a Contact Record and is required in order to call the URI below.

A popular Contact used for testing in our test database is 'Mary Investor'. So we will retrieve data by using her ContactID in the URI below.{contactid}/master


Below is a sample request in C# using the Master Fetch URI, sample credentials, and the method type. The content type "text/json" work equally well.

HttpWebRequest req = (HttpWebRequest)HttpWebRequest.Create("");
req.Headers[System.Net.HttpRequestHeader.Authorization] = "Basic " + Convert.ToBase64String(System.Text.Encoding.Default.GetBytes("6C135EDF-C37C-4039-AEF3-5DFC079F9E6A:Statementone:sonedemo"));
req.Method = "GET";
req.ContentType = "text/xml";

//and here's the response stream.
HttpWebResponse resp = (HttpWebResponse)req.GetResponse();
System.IO.StreamReader sr = new System.IO.StreamReader(resp.GetResponseStream());


 The corresponding response(xml) will be similar to the following. Be warned, there's a lot of data!


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Powered by Zendesk