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.
returns contact record by ContactID
returns a list of Address records for a ContactID
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.
https://api2.redtailtechnology.com/crm/v1/rest/contacts/{contactid}/master
https://api2.redtailtechnology.com/crm/v1/rest/contacts/384843/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("https://api2.redtailtechnology.com/crm/v1/rest/contacts/384843/master"); 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!
Comments