home > support > API > Marketplace API > search enquiries
| Purpose | Generate a list of previously created Enquiries. | |
|---|---|---|
| Notes | Marketplace partners can search for enquiries they have generated from 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. Returns newest first, however that is based on each individual channels local time when the enquiry was entered. | |
| REST info | Call | /p/enquiries/search /c/enquiries/search |
| Formats | XML | |
| Example | /c/enquiries/search.xml | |
| Verb | GET | |
| Code |
PHP examples use the PHP Client Library with SimpleXML Description
Parameters
ExampleC# examples use the .Net Client Library Overload list
Parameters
Example
VB examples use the .Net Client Library Overload list
Parameters
Example
| |
All are Optional
| Parameter | Notes |
|---|---|
| made_date_start | YYYY-MM-DD. Combine with the made_date_end to restrict results to just those enquiries created during a certain date period |
| made_date_end | YYYY-MM-DD. See made_start_date above. |
| unique | IF you are connected to multiple channels in the same account_id you may get the enquiry back multiple times! (unless you set unique =1) if you set unique =1 - you will get back just one XML entry per enquiry - but bear in mind that the channel ID listed there may not be the channel that it as actually submitted under (but will be a channel from the company) |
| customer_id | Use to search for enquiries made by a specific customer, only works if the channel ID is also supplied (channel id is passed in the header if calling the API directly or as the second parameter if using the PHP/.Net API wrappers) |
| per_page | Number of results to return per page. Default is 100. Max is 500 |
| page | Integer for which page number to return. Default is page 1 |
| 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 any enquiries are returned there will be an enquiry node containing the following child nodes.
|
| total_enquiries_count | The total number of enquiries returned by the search |
© 2003-2012 Travel UCD Limited. All rights reserved. TourCMS® is a registered trademark of Travel UCD Limited, United Kingdom. View Privacy policy.