{{ wiki:www.travanto.de.png}}
\\
\\
\\
\\
====== Enquiries Service ======

It is possible to retrieve all information about enquiries that have been made through our system. This service is only applicable for properties running in enquiry mode. The enquiry mode enables guests to only send an e-mal enquiry without the possibility to instantly book a property.

<WRAP center round tip 100%>
  * There is two main use cases for this service: 
    * Retrieving information for a new enquiry after a notification has been sent to your system (see [[api:services:push|Push notification service]] for further details)
    * Receive former e-mail enquiries to add them to your system.
</WRAP>

The general URL of this service is https://connect.travanto.de/service/enquiries. <wrap em>GET</wrap> is the only available method in this case to retrieve all relevant information abouts potential guests, travel dates and prices.

The [[api:services:schemata:enquiries|basic response scheme]] for the enquiry service provide you with a sound idea of how to use it.  


[schemata https://connect.travanto.de/schemata/response/EnquiriesService.json]

\\
-----
===== Authorization & Provided data =====
There is two ways to authorize in order to fetch information about enquiries.
  - You can use your existing API key enabling you to receive booking information or
  - If you also use the [[api:services:push|Push notification service]] we provide you with a token that can be used to retreive all enquiries for the property concerned.

\\
----


===== Retrieving enquiry information =====
After an enquiry has been made (or at any other point in time), you are able to retrieve all neccessary information using <wrap em>GET</wrap> method. You can either fetch information about once specific enquiry, for all enquiries of an entire property or all enquiries for properties authorized through your API key.

^ Method     ^ URL      ^ Description          ^ Authorization   ^
| GET |/service/enquiries/ | Get information about all enquiries related to your API key     | API key only |
| GET |/service/enquiries/?object_id=$object_id | Get information about all enquiries for one specific property    | API key & Token |
| GET |/service/enquiries/$enquiry_id | Get information for one single enquiry    | API Key & Token |




===== Example response =====
The following example will give you an idea about the response you can expect using this service. 


**Requested URL:** 

<code>
/service/enquiries/203306
</code>

**Response:**
[json]
{
  "OK": 1,
  "Request": {
    "Method": "GET",
    "Path": "/service/enquiries/203306"
  },
  "EnquiriesServiceResult": [
    {
      "enquiry_id": 203306,
      "object_id": 1000857,
      "stamp": "2017-04-25T13:33:42+02:00",
      "message": "Dear landlord,\nI have found your beautiful property and would like to rent it during these days.\nThank you for your reply.",
      "prices": {
        "total": 2077.5
      },
      "stay": {
        "arrival": "2017-10-06",
        "departure": "2017-10-13",
        "nights": 7,
        "persons": 2,
        "children": 2
      },
      "guest": {
        "language": "DE",
        "first_name": "Tim",
        "last_name": "Hochmuth",
        "address": "Teststraße, 5",
        "location": "Hamburg",
        "phone": "017123456789",
        "email": "t.hochmuth@travanto.de"
      }
    }
  ]
}
[/json]

----
\\

===== Important Information =====
<WRAP center round important 100%>
  * The example above does not feature any additional services that the guest might have chosen. This feature is being implemented right now. Please have a look at the scheme that already contains the neccessary information.
</WRAP>