Table of Contents
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.
- 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 Push notification service for further details)
- Receive former e-mail enquiries to add them to your system.
The general URL of this service is https://connect.travanto.de/service/enquiries. GET is the only available method in this case to retrieve all relevant information abouts potential guests, travel dates and prices.
The basic response scheme for the enquiry service provide you with a sound idea of how to use it.
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 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 GET 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:
/service/enquiries/203306
Response:
{
"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"
}
}
]
}
Important Information
- 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.