4. Hotel Extras
Last modified by Giorgi Mdivnishvili on 2024/02/27 22:06
Endpoint
https://restapi.rustaronline.com/v1.01/api/hotelextras
Method: GET
Parameters to pass: agented and agentpassword
Sample URL:
https://restapi.rustaronline.com/v1.01/api/hotelextras?agentid=test.test&agentpassword=TestP@ssw0rd
Request/Reponse
The method returns the list of gala dinners and other additional services mandatory or complimentary for stay at specific dates
Return value example:
{
"Code": "00",
"Message": "",
"Timestamp": "2016-10-25T17:02:41.7264196+04:00",
"Version": “1.01”,
"ResponseID": "385fcbce-843e-47ec-b962-3ced37831c9d",
"Data": [
{
"hotelid": "d5f11cf4-acc1-4c0e-9736-e45697a22031",
"hotelname": "Acacia By Bin Majid Hotels & Resorts",
"servicetype": {
"extraservicetypeid": "88ec1f35-4077-451b-a71f-0630fcc7fdff",
"extraservicetype": "GALA DINNER"
},
"service": {
"extraserviceid": "f6ebfdad-8964-4e3a-bf70-dfd7d7195ea3",
"extraservice": "NEW YEAR 2016 - 2017 GALA DINNER",
"servicedescriptionnote": "Inclusive of all kinds of Alcoholic and non-alcoholic drinks with Live Music and Entertainment Program.",
"serviceconditionsnote": "Minimum stay of Five (5) nights.",
"ismandatory": 1,
"serviceprices": [
{
"description": "GALA DINNER (on AI Basis)",
"adult": {
"priceid": "04c173f6-5b05-423b-b85e-115850e95fc9",
"currency": "USD",
"price": 88.0000000000000000000
},
"teen": {
"priceid": "04c173f6-5b05-423b-b85e-115850e95fc9",
"maxage": 20.99,
"currency": "USD",
"price": 88.0000000000000000000
},
"child": {
"priceid": "fb933a2b-7c31-4809-9f4d-565abcf1c27f",
"maxage": 11.99,
"currency": "USD",
"price": 44.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
},
{
"description": "GALA DINNER (on BB Basis)",
"adult": {
"priceid": "46daffc1-3838-451d-af08-25c42e03ad8d",
"currency": "USD",
"price": 144.0000000000000000000
},
"teen": {
"priceid": "46daffc1-3838-451d-af08-25c42e03ad8d",
"maxage": 20.99,
"currency": "USD",
"price": 144.0000000000000000000
},
"child": {
"priceid": "b5123684-4cf7-4216-bf29-a4574487be7d",
"maxage": 11.99,
"currency": "USD",
"price": 72.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
},
{
"description": "GALA DINNER (on FB Basis)",
"adult": {
"priceid": "9f7ce6fe-71a2-4c59-b80b-7eead8ad665b",
"currency": "USD",
"price": 100.0000000000000000000
},
"teen": {
"priceid": "9f7ce6fe-71a2-4c59-b80b-7eead8ad665b",
"maxage": 20.99,
"currency": "USD",
"price": 100.0000000000000000000
},
"child": {
"priceid": "bba98523-40f2-47e0-b924-0a649606200a",
"maxage": 11.99,
"currency": "USD",
"price": 50.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
},
{
"description": "GALA DINNER (on HB Basis)",
"adult": {
"priceid": "958430e8-f0de-41af-a5a4-fa33e76ae00b",
"currency": "USD",
"price": 116.0000000000000000000
},
"teen": {
"priceid": "958430e8-f0de-41af-a5a4-fa33e76ae00b",
"maxage": 20.99,
"currency": "USD",
"price": 116.0000000000000000000
},
"child": {
"priceid": "083165a3-28d6-410a-afbf-ddb1ce816a62",
"maxage": 11.99,
"currency": "USD",
"price": 58.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
}
],
"serviceconditions": [
{
"bookingstartdate": null,
"bookingenddate": null,
"bookbefore": null,
"minimumstay": 5,
"stayperiodstart": "2016-12-31T00:00:00",
"stayperiodend": "2017-01-01T00:00:00"
}
]
}
},
{
"hotelid": "78b20d33-83a6-4913-9777-dafbf9520ff1",
"hotelname": "Ajman Beach Hotel",
"servicetype": {
"extraservicetypeid": "88ec1f35-4077-451b-a71f-0630fcc7fdff",
"extraservicetype": "GALA DINNER"
},
"service": {
"extraserviceid": "6f1633df-f800-408b-a215-5c79772bf025",
"extraservice": "NEW YEAR 2016 - 2017 GALA DINNER",
"servicedescriptionnote": null,
"serviceconditionsnote": null,
"ismandatory": 1,
"serviceprices": [
{
"description": "GALA DINNER",
"adult": {
"priceid": "bcbcc8a8-0254-4750-bb70-6feb973b3f45",
"currency": "USD",
"price": 116.0000000000000000000
},
"teen": {
"priceid": "bcbcc8a8-0254-4750-bb70-6feb973b3f45",
"maxage": 20.99,
"currency": "USD",
"price": 116.0000000000000000000
},
"child": {
"priceid": "f1f6f0d6-884c-4d39-8e19-3e621b9e5f35",
"maxage": 11.99,
"currency": "USD",
"price": 58.0000000000000000000
},
"infant": {
"priceid": "ff32ba32-1289-4189-89d0-569519627d34",
"maxage": 5.99,
"currency": "USD",
"price": 0.0
}
}
],
"serviceconditions": [
{
"bookingstartdate": null,
"bookingenddate": null,
"bookbefore": null,
"minimumstay": null,
"stayperiodstart": "2016-12-31T00:00:00",
"stayperiodend": "2017-01-01T00:00:00"
}
]
}
}
]
}
"Code": "00",
"Message": "",
"Timestamp": "2016-10-25T17:02:41.7264196+04:00",
"Version": “1.01”,
"ResponseID": "385fcbce-843e-47ec-b962-3ced37831c9d",
"Data": [
{
"hotelid": "d5f11cf4-acc1-4c0e-9736-e45697a22031",
"hotelname": "Acacia By Bin Majid Hotels & Resorts",
"servicetype": {
"extraservicetypeid": "88ec1f35-4077-451b-a71f-0630fcc7fdff",
"extraservicetype": "GALA DINNER"
},
"service": {
"extraserviceid": "f6ebfdad-8964-4e3a-bf70-dfd7d7195ea3",
"extraservice": "NEW YEAR 2016 - 2017 GALA DINNER",
"servicedescriptionnote": "Inclusive of all kinds of Alcoholic and non-alcoholic drinks with Live Music and Entertainment Program.",
"serviceconditionsnote": "Minimum stay of Five (5) nights.",
"ismandatory": 1,
"serviceprices": [
{
"description": "GALA DINNER (on AI Basis)",
"adult": {
"priceid": "04c173f6-5b05-423b-b85e-115850e95fc9",
"currency": "USD",
"price": 88.0000000000000000000
},
"teen": {
"priceid": "04c173f6-5b05-423b-b85e-115850e95fc9",
"maxage": 20.99,
"currency": "USD",
"price": 88.0000000000000000000
},
"child": {
"priceid": "fb933a2b-7c31-4809-9f4d-565abcf1c27f",
"maxage": 11.99,
"currency": "USD",
"price": 44.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
},
{
"description": "GALA DINNER (on BB Basis)",
"adult": {
"priceid": "46daffc1-3838-451d-af08-25c42e03ad8d",
"currency": "USD",
"price": 144.0000000000000000000
},
"teen": {
"priceid": "46daffc1-3838-451d-af08-25c42e03ad8d",
"maxage": 20.99,
"currency": "USD",
"price": 144.0000000000000000000
},
"child": {
"priceid": "b5123684-4cf7-4216-bf29-a4574487be7d",
"maxage": 11.99,
"currency": "USD",
"price": 72.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
},
{
"description": "GALA DINNER (on FB Basis)",
"adult": {
"priceid": "9f7ce6fe-71a2-4c59-b80b-7eead8ad665b",
"currency": "USD",
"price": 100.0000000000000000000
},
"teen": {
"priceid": "9f7ce6fe-71a2-4c59-b80b-7eead8ad665b",
"maxage": 20.99,
"currency": "USD",
"price": 100.0000000000000000000
},
"child": {
"priceid": "bba98523-40f2-47e0-b924-0a649606200a",
"maxage": 11.99,
"currency": "USD",
"price": 50.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
},
{
"description": "GALA DINNER (on HB Basis)",
"adult": {
"priceid": "958430e8-f0de-41af-a5a4-fa33e76ae00b",
"currency": "USD",
"price": 116.0000000000000000000
},
"teen": {
"priceid": "958430e8-f0de-41af-a5a4-fa33e76ae00b",
"maxage": 20.99,
"currency": "USD",
"price": 116.0000000000000000000
},
"child": {
"priceid": "083165a3-28d6-410a-afbf-ddb1ce816a62",
"maxage": 11.99,
"currency": "USD",
"price": 58.0000000000000000000
},
"infant": {
"priceid": "e5d695b2-e5f4-4c3e-a947-e98cbf52ba06",
"maxage": 3.99,
"currency": "USD",
"price": 0.0
}
}
],
"serviceconditions": [
{
"bookingstartdate": null,
"bookingenddate": null,
"bookbefore": null,
"minimumstay": 5,
"stayperiodstart": "2016-12-31T00:00:00",
"stayperiodend": "2017-01-01T00:00:00"
}
]
}
},
{
"hotelid": "78b20d33-83a6-4913-9777-dafbf9520ff1",
"hotelname": "Ajman Beach Hotel",
"servicetype": {
"extraservicetypeid": "88ec1f35-4077-451b-a71f-0630fcc7fdff",
"extraservicetype": "GALA DINNER"
},
"service": {
"extraserviceid": "6f1633df-f800-408b-a215-5c79772bf025",
"extraservice": "NEW YEAR 2016 - 2017 GALA DINNER",
"servicedescriptionnote": null,
"serviceconditionsnote": null,
"ismandatory": 1,
"serviceprices": [
{
"description": "GALA DINNER",
"adult": {
"priceid": "bcbcc8a8-0254-4750-bb70-6feb973b3f45",
"currency": "USD",
"price": 116.0000000000000000000
},
"teen": {
"priceid": "bcbcc8a8-0254-4750-bb70-6feb973b3f45",
"maxage": 20.99,
"currency": "USD",
"price": 116.0000000000000000000
},
"child": {
"priceid": "f1f6f0d6-884c-4d39-8e19-3e621b9e5f35",
"maxage": 11.99,
"currency": "USD",
"price": 58.0000000000000000000
},
"infant": {
"priceid": "ff32ba32-1289-4189-89d0-569519627d34",
"maxage": 5.99,
"currency": "USD",
"price": 0.0
}
}
],
"serviceconditions": [
{
"bookingstartdate": null,
"bookingenddate": null,
"bookbefore": null,
"minimumstay": null,
"stayperiodstart": "2016-12-31T00:00:00",
"stayperiodend": "2017-01-01T00:00:00"
}
]
}
}
]
}
Definitions
| Value | Description |
| hotelid | GUID of the hotel in the database of Rustar. This GUID will be used to retrieve additional information (like prices) about the hotel |
| hotelname | string. Name of the hotel |
| servicetype | Object type of service/gala dinner |
| roomcategorytype | GUID of the Room category type. Unique by description of the room |
| roomcategoryname | string. The name of the room category |
| extraservicetypeid | GUID of the service type. Unique for GALA DINNER, CHRISTMAS DINNER etc |
| extraservicetype | Sstring. The name of the extra service type. E.g. GALA DINNER |
| extraserviceid | GUID of the extra service provided/requested by the hotel |
| extraservice | String. The name of the service/extra for the specific hotel. E.g. NEW YEAR GALA DINNER IN ATLANTIS |
| servicedescriptionnote | String. Optional description to be displayed to client. The description explains the conditions of the gala dinner in human readable format |
| serviceconditionsnote | String. Optional description of conditions of the service to be displayed to client. The conditions displayed are in human readable format |
| ismandatory | Boolean. 1 if this dinner/service is mandatory for the stay. 0 if using of this service/dinner is optional |
| serviceprices | Array of different options for gala dinners/extra services |
| description | Description of one of the option |
| adult | Price for the adult |
| teen | Price for the teenager (Age is specified in maxage property) |
| child | Price for the child (Age is specified in maxage property) |
| infant | Price for the infant (Age is specified in maxage property). If priceid is null, then infant is not allowed |
| serviceconditions | conditions to be met in order to request this dinner/service |
| bookingstartdate | If not null, then the booking should be done starting from this date |
| bookingenddate | If not null, then the booking should be done ending this date |
| minimumstay | If not null, then the booking duration should be at least the specified days |
| stayperiodstart | If not null, then the reservation (stay date) should be starting from specified date |
| stayperiodend | If not null, then the reservation (stay date) should end before specified date |