home > support > API > Marketplace API > show enquiry
View the details of a specific enquiry
Marketplace partners can view enquiries they have generated on any channel that have granted them permission level 2 or above when connecting. Enquiries will not be listed from Channels who have only granted level 1 permission. You can check permissions on your channels via the Your connections section of your control panel or by calling the Show Channel API call.
Endpoint | /c/enquiry/show |
Formats | XML |
Example | /c/enquiry/show.xml?enquiry_id=12345 |
Verb | GET |
PHP examples use the PHP Client Library with SimpleXML
object show_enquiry ( int $enquiry, int $channel )
// Set the channel ID
// For tour operators this can be found in their API settings page
// For Marketplace Partners set this to the channel the Enquiry is in
$channel = 3;
// Set the enquiry ID
$enquiry = 12345
// Query the TourCMS API
$result = $tourcms->show_enquiry($enquiry, $channel);
// Print out some details regarding the enquiry
$enquiry = $result->enquiry;
print $enquiry->enquiry_id." - ".$enquiry->status_text;
12345 - Triage
C# examples use the .Net Client Library
XmlDocument ShowEnquiry (int enquiryId, int channelId)
// ID for the enquiry
int enquiryId = 12345;
// ID for the channel (supplier) the enquiry belongs to
int channelId = 3;
// Call the TourCMS API
XmlDocument doc = myTourCMS.ShowEnquiry(enquiryId, channelId);
// Check the status of the response
string status = doc.SelectSingleNode("//error").InnerText;
// If the status is "OK" TourCMS will have returned our Enquiry
if ( status == "OK" )
{
// Success! Print out the ID and Status Text
string sText = doc.SelectSingleNode("//enquiry/status_text").InnerText;
Console.WriteLine(enquiryId + " - " + sText);
} else {
// Failure! Print out the error text to debug
Console.WriteLine("Error: " + status);
}
12345 - Triage
VB examples use the .Net Client Library
XmlDocument ShowEnquiry (Integer enquiryId, Integer channelId)
' ID for the enquiry
Dim enquiryId As Integer = 12345
' ID for the channel (supplier) the enquiry belongs to
Dim channelId As Integer = 3;
' Call the TourCMS API
Dim doc As XmlDocument = myTourCMS.ShowEnquiry(enquiryId, channelId)
' Check the status of the response
Dim status As String = doc.SelectSingleNode("//error").InnerText
' If the status is "OK" TourCMS will have returned our Enquiry
If status = "OK" Then
' Success! Print out the ID and Status Text
Dim sText As String = doc.SelectSingleNode("//enquiry/status_text").InnerText;
Console.WriteLine(enquiryId & " - " & sText)
Else
' Failure! Print out the error text to debug
Console.WriteLine("Error: " & status)
End If
12345 - Triage
Enter your TourCMS API credentials below to call the Show Enquiry endpoint.
Parameter | Notes |
---|---|
enquiry_id | ID number for the enquiry, for those using the API wrapper libraries this is passed as the first parameter (the second being the corresponding channel ID) |
Returns the same information as the Enquiry Search method, just restricted to a single enquiry.
XML Node | Notes |
---|---|
request | Confirmation of the request that you sent |
error | Any error message returned, if there is no error this will just contain the text OK | enquiry |
If an enquiry is found there will be an enquiry node containing the following child nodes.
|