Hotel API · Reservations & credit
TripBookingList()
This function is dedicated to mTrip.com mobile application to get hotels and flight bookings made since specific date time and filters on the id Member if needed.
Request
XML Format
<TripBookingListRQ>
<Credential>
<Login>?</Login>
<Password>?</Password>
</Credential>
<User>?</User>
<IdMember>?</IdMember>
<Ilng>?</Ilng>
<FromDate>?</FromDate>
</TripBookingListRQ>JSON Format
{
"TripBookingListRQ": {
"Credential": {
"Login": "?",
"Password": "?"
},
"User": "?",
"Ilng": "?",
"FromDate": "?"
}
}| Root | Sub root | Description | Values & Format | Tag |
|---|---|---|---|---|
| Credential | ||||
| Login | String | Mandatory | ||
| Password | String | Mandatory | ||
| User | IdUser on CYBERESA SYSTEM | Integer | Mandatory | |
| IdMember | Id Member | Integer | Optional | |
| Ilng | Id of language | Numeric | Optional | |
| FromDate | Retrieve bookings based on creation datetime | yyyy/mm/dd hh:mm:ss.000 | Mandatory |
Response
JSON Format
{
"TripBookingListRS": {
"Bookings": {
"Booking": [
{
"@kind": "accommodation",
"booking_number": "?",
"name": "?",
"from_date": "?",
"to_date": "?",
"adress": "?",
"picture_url": "?",
"tyoe_of_room": "?",
"city": "?",
"phone": "?",
"email": "?",
"location": {
"latitude": "?",
"longitude": "?"
},
"travelers": {
"?": [
{
"name": "?",
"type_of_room": "?"
},
{
"name": "?",
"type_of_room": "?"
},
{
"name": "?",
"type_of_room": "?"
},
{
"name": "?",
"type_of_room": "?"
}
]
}
},
{
"@kind": "transport",
"reservation_reference": "?",
"transport_number": "?",
"class": "?",
"departure_date": "?",
"departure_city": "?",
"arrival_city": "?",
"airline_company": "?",
"departure_airport": "?",
"departure_airport_iata": "?",
"arrival_airport": "?",
"arrival_airport_iata": "?",
"departure_terminal": "?",
"arrival_terminal": "?",
"arrival_date": "?",
"duration": "?",
"departure_location": {
"latitude": "?",
"longitude": "?"
},
"Arrival_location": {
"latitude": "?",
"longitude": "?"
},
"travelers": {
"traveler": {
"name": " ?",
"ticket_number": "?"
}
}
}
]
}
}
}| Root | Sub root | Description | Values & Format | Tag |
|---|---|---|---|---|
| booking | [kind] | Details of booking | string, possible values [kind="transport"] [kind="accommodation"] | |
| [kind="transport"] | Details of transport object | |||
| reservation_reference | Id Airticket on CYBERESA SYSTEM | string | Mandatory | |
| transport_number | The number identifying the transport, e.g. the flight number for a flight(PNR) | string | Mandatory | |
| class | The transportation mode type | string, possible values C,M, Economy With Restrictions… | Mandatory | |
| departure_date | Departure date | datetime | Mandatory | |
| departure_city | The city from where the transport leaves | string | Mandatory | |
| arrival_city | The city to where the transport goes | string | Optional | |
| airline_company | The company operating the transport | string | Optional | |
| departure_airport | The departure airport of a flight or the departure station for other transport mode | string | Optional | |
| departure_airport_iata | IATA code of the airport | String | Optional | |
| arrival_airport | The arrival airport or the arrival station for other transport mode | string | Optional | |
| arrival_airport_iata | IATA code of the airport | string | Optional | |
| departure_terminal | The departure terminal | string | Optional | |
| arrival_terminal | The arrival terminal | string | Optional | |
| arrival_date | Arrival date | datetime | Optional | |
| duration | Duration of the trip | time Format: 1h :30m | Optional | |
| departure_location | Departure geo-location | location | Optional | |
| departure_location > latitude | Latitude | location | Optional | |
| departure_location > longitude | Longitude | location | Optional | |
| arrival_location | Arrival geo-location | location | Optional | |
| arrival_location > latitude | Latitude | location | Optional | |
| arrival_location > longitude | Longitude | location | Optional | |
| travelers | An array of Traveler Details | Mandatory | ||
| travelers>traveler | Details of each traveler | Mandatory | ||
| travelers>traveler> name | Traveler’s name | string | Mandatory | |
| travelers>traveler> ticket_number | Traveler’s e-ticket | string | Mandatory | |
| [kind="accommodation"] | Details of accomodation object | |||
| booking_number | The booking number for the accommodation | string | Mandatory | |
| name | Hotel title | string | Mandatory | |
| from_date | Check-in date | date | Mandatory | |
| to_date | Check-out date | date | Mandatory | |
| location | Geo-location of the accommodation | location | Optional | |
| location > latitude | Latitude | location | Optional | |
| location > longitude | Longitude | location | Optional | |
| address | Address of the hotel | string | Optional | |
| picture_url | URL to an image | string | Optional | |
| type_of_room | The type of room booked | string | Optional | |
| city | Name of the destination to which the accommodation should be attached to. | string | Mandatory | |
| phone | Phone number (recommended format: +[country code] [phone number]) | string | Optional | |
| Email address | string | Optional | ||
| travelers | An array of Traveler Details | Mandatory | ||
| travelers>traveler | Details of each traveler | Mandatory | ||
| travelers>traveler> name | traveler’s name | string | Mandatory | |
| travelers>traveler> type_of_room | The type of room booked | string | Optional |