Changes for page SearchTourPackages - Basic Version
Last modified by Giorgi Mdivnishvili on 2025/10/22 13:39
From version 9.1
edited by Giorgi Mdivnishvili
on 2024/04/11 11:27
on 2024/04/11 11:27
Change comment:
There is no comment for this version
To version 2.1
edited by Giorgi Mdivnishvili
on 2024/04/11 09:31
on 2024/04/11 09:31
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -25,52 +25,123 @@ 25 25 ))) 26 26 27 27 28 -== Request example==28 +== Request Body == 29 29 30 30 {{code language="Json"}} 31 31 { 32 - "departureCountryCode": "KZ", 33 - "departureCityUID": "f0ba6324-f337-405c-8cc7-23d62cf664e8", 34 - "arrivalCountryCode": "AE", 35 - "adults": 2, 36 - "children": 0, 37 - "departureDate": "2024-05-25T00:00:00", 38 - "returnDate": "2024-06-01T00:00:00", 39 - "departureAndReturnDaysCount": 7, 40 - "checkInDate": "2024-05-25T00:00:00", 41 - "checkOutDate": "2024-06-01T00:00:00", 42 - "checkInAndCheckOutDaysCount": 7, 43 - "directFlightsOnly": true, 44 - "pageRowCount": 25, 45 - "searchCurrency": "USD" 32 + "departureCountryCode": "string", 33 + "departureCityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 34 + "arrivalCountryCode": "string", 35 + "arrivalLocations": [ 36 + { 37 + "type": "string", 38 + "parent": "string", 39 + "label": "string", 40 + "subLabel": "string", 41 + "value": "string", 42 + "tag": "string" 43 + } 44 + ], 45 + "checkInDate": "2023-12-14", 46 + "checkInDateTo": "2023-12-14", 47 + "checkOutDate": "2023-12-14", 48 + "stayDays": 0, 49 + "stayDaysTo": 0, 50 + "departureDate": "2023-12-14", 51 + "returnDate": "2023-12-14", 52 + "airlineCode": "string", 53 + "ticketType": "string", 54 + "directFlightsOnly": true, 55 + "longConnectTime": true, 56 + "adults": 0, 57 + "children": 0, 58 + "childrenAges": [ 59 + 0 60 + ], 61 + "extendedSearch": true, 62 + "totalPriceFrom": 0, 63 + "totalPriceTo": 0, 64 + "recommended": true, 65 + "popular": true, 66 + "freeSale": true, 67 + "groupByHotel": true, 68 + "hotelCodes": [ 69 + "string" 70 + ], 71 + "mealPlans": [ 72 + "string" 73 + ], 74 + "hotelClasses": [ 75 + "string" 76 + ], 77 + "hotelTypes": [ 78 + "CityHotel" 79 + ], 80 + "hotelServices": [ 81 + "HasAlcohol" 82 + ], 83 + "pagingId": "string", 84 + "pageNumber": 0, 85 + "pageRowCount": 0 46 46 } 47 47 {{/code}} 48 48 49 -== Request example 2Adults 2Child == 50 50 90 +== Request example == 91 + 51 51 {{code language="Json"}} 52 52 { 53 - "departureCountryCode": "KZ", 54 - "departureCityUID": "f0ba6324-f337-405c-8cc7-23d62cf664e8", 55 - "arrivalCountryCode": "AE", 56 - "adults": 2, 57 - "children": 2, 58 - "childrenAges": [ 59 - 4, 60 - 8 94 + "departureCountryCode": "KZ", 95 + "departureCityUID": "f0ba6324-f337-405c-8cc7-23d62cf664e8", 96 + "arrivalCountryCode": "AE", 97 + "arrivalLocations": [ 98 + { 99 + "type": "city", 100 + "label": "Dubai", 101 + "value": "f5185fa3-3f56-44ed-bf6b-80386a33caa2", 102 + "tag": "Dubai" 103 + } 61 61 ], 62 - "departureDate": "2024-05-26T00:00:00", 63 - "returnDate": "2024-06-02T00:00:00", 64 - "departureAndReturnDaysCount": 7, 65 - "checkInDate": "2024-05-26T00:00:00", 66 - "checkOutDate": "2024-06-02T00:00:00", 67 - "checkInAndCheckOutDaysCount": 7, 68 - "directFlightsOnly": true, 69 - "searchCurrency": "USD", 105 + "checkInDate": "2024-02-05T20:00:00.000Z", 106 + "checkInDateTo": "2024-02-10T20:00:00.000Z", 107 + 108 + "stayDays": 3, 109 + "stayDaysTo": 6, 70 70 71 - "pagingId": "", 72 - "pageNumber": 1, 73 - "pageRowCount":5 111 + "airlineCode": "", 112 + "ticketType": "", 113 + "directFlightsOnly": true, 114 + "longConnectTime": true, 115 + "adults": 1, 116 + "children": 1, 117 + "childrenAges": [ 118 + 2 119 + ], 120 + "extendedSearch": false, 121 + "totalPriceFrom": 100, 122 + "totalPriceTo": 15000, 123 + "recommended": true, 124 + "popular": true, 125 + "freeSale": true, 126 + "groupByHotel": true, 127 + "hotelCodes": [ 128 + 129 + ], 130 + "mealPlans": [ 131 + 132 + ], 133 + "hotelClasses": [ 134 + 135 + ], 136 + "hotelTypes": [ 137 + 138 + ], 139 + "hotelServices": [ 140 + 141 + ], 142 + "pagingId": "", 143 + "pageNumber": 10, 144 + "pageRowCount": 10 74 74 } 75 75 {{/code}} 76 76 ... ... @@ -260,173 +260,129 @@ 260 260 { 261 261 "packages": [ 262 262 { 263 - "id": "tour:556ce3c2-4062-4181-9970-f41e1aeb3b8b:ce81c22f-7d91-4237-9a2a-43c4c4bcb62f:1d8793e6-346e-4b5c-933f-3d8637684d7e", 334 + "cacheKey": "c705ab31e00e4f9a81c2fd46b2cdbb47f6fd9a6e16984236beb979b31aefafa4:{79}:i:10", 335 + "id": "tour:b01c168e-2ea7-4ea6-b6e0-55abb8cab0a0:da894a1e-88c0-4877-b216-0eeeabe186f3:4298d06f-4344-4a39-ad98-071b7760cf30", 264 264 "priceCurrency": "USD", 265 - "totalPrice": 909.78,337 + "totalPrice": 1033.53, 266 266 "agentCommissionPercent": 0.0, 267 267 "agentCommissionAmount": 0.0, 268 268 "includedExtrasAmount": 0, 269 269 "priceDifference": 0, 270 270 "hotel": { 271 - "hotelPriceId": "ce81c22f-7d91-4237-9a2a-43c4c4bcb62f", 272 - "hotelName": "CityMax Sharjah", 273 - "hotelCode": "CMAXBSHJNUG", 274 - "nigths": 7, 343 + "hotelPriceId": "da894a1e-88c0-4877-b216-0eeeabe186f3", 344 + "providerId": 13, 345 + "hotelName": "Mercure Dubai Barsha Heights Suites Apartments", 346 + "hotelCode": "5f125310-7025-4807-a4c6-49cd284c9c14", 347 + "nigths": 3, 275 275 "mealPlan": "BB", 276 - "hotelClass": "3", 277 - "hotelColor": "#228B22", 349 + "hotelClass": "4", 278 278 "availabilityType": "FreeSale", 279 279 "availableRoomsCount": 0, 280 280 "fewRooms": true, 281 - "roomCategoryCode": "DBL", 282 - "roomCategoryName": "Standard Room", 283 - "placementTypeName": "2 Adults", 284 - "placementDescription": "MARPROMDMC02/RUS", 285 - "checkInDate": "2024-05-25T00:00:00.000", 286 - "checkOutDate": "2024-06-01T00:00:00.000", 287 - "adults": 2, 288 - "children": 0, 289 - "districtUID": "7ac1bbc8-59ea-4977-b272-ed8553f94f9b", 290 - "districtName": "Sharjah", 291 - "cityUID": "f78ac3bc-f040-46d0-8319-2c52083080a6", 292 - "cityName": "Sharjah", 353 + "roomCategoryCode": "bc5f2224-bd4c-49b2-ab57-01eb7fa80d41", 354 + "roomCategoryName": "1 B/R Suite City View", 355 + "placementTypeName": "DBL", 356 + "checkInDate": "2024-02-09T20:00:00.000Z", 357 + "checkOutDate": "2024-02-12T20:00:00.000Z", 358 + "adults": 1, 359 + "children": 1, 360 + "districtUID": "4c65f6ed-902b-4fd8-9419-af7884c22c5e", 361 + "districtName": "Al Barsha", 362 + "cityUID": "f5185fa3-3f56-44ed-bf6b-80386a33caa2", 363 + "cityName": "Dubai", 293 293 "countryCode": "AE", 294 294 "countryName": "United Arab Emirates", 295 295 "hasAlcohol": false, 296 296 "hasFreeWifi": true, 297 - "hasMetro": false, 298 - "hasPool": false, 299 - "hasMall": true, 300 - "infantMaxAge": 4.99, 301 - "childMinAge": 5.0, 302 - "childMaxAge": 11.99, 303 - "teenMinAge": 0.0, 304 - "teenMaxAge": 0.0, 305 - "adultMinAge": 12.0, 306 - "cancellationPolicyDescription": "Cancellation Policy: 2 Day Before Arrival: 1.00 Night, Early Departure: 1.00 Night, NoShow: 1.00 Night", 368 + "hasMetro": true, 369 + "hasPool": true, 370 + "hasMall": false, 371 + "cancellationPolicyDescription": "Cancellation Policy: 5 Day Before Arrival: 100.00 %, Early Departure: 100.00 %, NoShow: 100.00 %", 307 307 "cancellationPolicy": { 308 - "noShowChargeValue": 1.0, 309 - "noShowChargeValueType": " Night",310 - "earlyDepartureChargeValue": 1.0, 311 - "earlyDepartureChargeValueType": " Night",373 + "noShowChargeValue": 100.0, 374 + "noShowChargeValueType": "%", 375 + "earlyDepartureChargeValue": 100.0, 376 + "earlyDepartureChargeValueType": "%", 312 312 "conditions": [ 313 313 { 314 - "timeunits": 2,379 + "timeunits": 5, 315 315 "timeunitType": "Day", 316 316 "timeOffsetTypeName": "Before Arrival", 317 - "chargeValue": 1.0, 318 - "chargeValueType": " Night"382 + "chargeValue": 100.0, 383 + "chargeValueType": "%" 319 319 } 320 320 ] 321 321 } 322 322 }, 323 323 "flight": { 324 - "id": " 1d8793e6-346e-4b5c-933f-3d8637684d7e",325 - "departureDate": "2024-0 5-25T00:00:00.000",326 - "returnDate": "2024-0 6-01T00:00:00.000",327 - "departureTicketsLeft": 48,328 - "returnTicketsLeft": 33,329 - "departureAvailabilityType": "F reeSale",330 - "returnAvailabilityType": "F reeSale",389 + "id": "4298d06f-4344-4a39-ad98-071b7760cf30", 390 + "departureDate": "2024-02-09T20:00:00.000Z", 391 + "returnDate": "2024-02-12T20:00:00.000Z", 392 + "departureTicketsLeft": 7, 393 + "returnTicketsLeft": 7, 394 + "departureAvailabilityType": "FewPlaces", 395 + "returnAvailabilityType": "FewPlaces", 331 331 "isTwoWay": true, 332 332 "sameBaggageForAll": false, 333 333 "totalBaggage": false, 334 - "isBlock": true, 335 - "class": "Economy", 336 336 "departureSegments": [ 337 337 { 338 - "airlineCode": " FZ",339 - "airlineName": " FlyDubai",340 - "flightCode": " FZ1722",341 - "class": " Economy",401 + "airlineCode": "KC", 402 + "airlineName": "Air Astana-", 403 + "flightCode": "KC897", 404 + "class": "econom", 342 342 "lugageWeight": 20, 343 343 "handLugageWeight": 6, 344 - "departureFlightDate": "2024-0 5-25T03:35:00.000",407 + "departureFlightDate": "2024-02-09T20:00:00.000Z", 345 345 "departureCountryName": "Kazakhstan", 346 346 "departureCityName": "Almaty", 347 347 "departureAirportCode": "ALA", 348 348 "departureAirportName": "Almaty Intl Airport", 349 349 "departureTerminalCode": "ALA", 350 - "arrivalFlightDate": "2024-0 5-25T07:10:00.000",413 + "arrivalFlightDate": "2024-02-09T20:00:00.000Z", 351 351 "arrivalCountryName": "United Arab Emirates", 352 352 "arrivalCityName": "Dubai", 353 353 "arrivalAirportCode": "DXB", 354 354 "arrivalAirportName": "Dubai Intl Airport", 355 - "arrivalTerminalCode": "DXB 3",356 - "flightDuration": " 5h35m"418 + "arrivalTerminalCode": "DXB1", 419 + "flightDuration": "0h 50m" 357 357 } 358 358 ], 359 359 "returnSegments": [ 360 360 { 361 - "airlineCode": " FZ",362 - "airlineName": " FlyDubai",363 - "flightCode": " FZ1721",364 - "class": " Economy",424 + "airlineCode": "KC", 425 + "airlineName": "Air Astana-", 426 + "flightCode": "KC900", 427 + "class": "econom", 365 365 "lugageWeight": 20, 366 366 "handLugageWeight": 6, 367 - "departureFlightDate": "2024-0 6-01T21:25:00.000",430 + "departureFlightDate": "2024-02-12T20:00:00.000Z", 368 368 "departureCountryName": "United Arab Emirates", 369 369 "departureCityName": "Dubai", 370 370 "departureAirportCode": "DXB", 371 371 "departureAirportName": "Dubai Intl Airport", 372 - "departureTerminalCode": "DXB 3",373 - "arrivalFlightDate": "2024-0 6-02T02:35:00.000",435 + "departureTerminalCode": "DXB1", 436 + "arrivalFlightDate": "2024-02-12T20:00:00.000Z", 374 374 "arrivalCountryName": "Kazakhstan", 375 375 "arrivalCityName": "Almaty", 376 376 "arrivalAirportCode": "ALA", 377 377 "arrivalAirportName": "Almaty Intl Airport", 378 378 "arrivalTerminalCode": "ALA", 379 - "flightDuration": " 3h 10m"442 + "flightDuration": "8h 15m" 380 380 } 381 381 ], 382 382 "passengers": [ 383 383 { 384 - "id": " 1d8793e6-346e-4b5c-933f-3d8637684d7e-A1",447 + "id": "42768722011000004-A1", 385 385 "isAdult": true, 386 - "selectedForwardBaggageCode": "INCLUDED", 387 - "selectedBackwardBaggageCode": "INCLUDED", 388 - "forwardBaggages": [ 389 - { 390 - "baggageCode": "INCLUDED", 391 - "description": "20 Kg Included", 392 - "price": 0.0, 393 - "currency": "USD", 394 - "included": true 395 - } 396 - ], 397 - "backwardBaggages": [ 398 - { 399 - "baggageCode": "INCLUDED", 400 - "description": "20 Kg Included", 401 - "price": 0.0, 402 - "currency": "USD", 403 - "included": true 404 - } 405 - ] 449 + "forwardBaggages": [], 450 + "backwardBaggages": [] 406 406 }, 407 407 { 408 - "id": "1d8793e6-346e-4b5c-933f-3d8637684d7e-A2", 409 - "isAdult": true, 410 - "selectedForwardBaggageCode": "INCLUDED", 411 - "selectedBackwardBaggageCode": "INCLUDED", 412 - "forwardBaggages": [ 413 - { 414 - "baggageCode": "INCLUDED", 415 - "description": "20 Kg Included", 416 - "price": 0.0, 417 - "currency": "USD", 418 - "included": true 419 - } 420 - ], 421 - "backwardBaggages": [ 422 - { 423 - "baggageCode": "INCLUDED", 424 - "description": "20 Kg Included", 425 - "price": 0.0, 426 - "currency": "USD", 427 - "included": true 428 - } 429 - ] 453 + "id": "42768722011000004-C1", 454 + "isAdult": false, 455 + "forwardBaggages": [], 456 + "backwardBaggages": [] 430 430 } 431 431 ] 432 432 }, ... ... @@ -433,24 +433,19 @@ 433 433 "extraServices": [], 434 434 "insurancePrice": { 435 435 "name": "Medical INS (N10000)", 436 - "price": 35.84, 437 - "actualStartDate": "2024-05-25T00:00:00.000", 438 - "actualEndDate": "2024-06-01T00:00:00.000", 463 + "price": 17.92, 464 + "priceSurcarge": 0.0, 465 + "actualStartDate": "2024-02-09T20:00:00.000Z", 466 + "actualEndDate": "2024-02-12T20:00:00.000Z", 439 439 "optional": false, 440 440 "includedInPackagePrice": true 441 - }, 442 - "cacheKey": "bd7e9a28fb744528a2deb043f05e0502602ea56f943a4dc9805321db85d51137:{9}:i:1", 443 - "sortCheckInOut": "25.05.2024-01.06.2024", 444 - "sortAirline": "fly dubai", 445 - "sortHotelName": "citymax sharjah", 446 - "sortDetails": "bb", 447 - "sortPlacement": "standard room 2 adults" 469 + } 448 448 } 449 449 ], 450 - "pagingId": "9", 451 - "pageNumber": 1, 452 - "pageCount": 883,453 - "totalCount": 883,472 + "pagingId": "79", 473 + "pageNumber": 10, 474 + "pageCount": 2452, 475 + "totalCount": 2452, 454 454 "error": false 455 455 } 456 456 {{/code}} ... ... @@ -739,107 +739,113 @@ 739 739 == Definitions == 740 740 741 741 742 - ===**Request Parameters **===764 +**Request Parameters ** 743 743 744 744 (% class="table-bordered" %) 745 -|=Key|=Type|=Nullable|=Description 746 -|departureCountryCode|String|No|The ISO 3166-1 alpha-2 code of the departure country. For example, "KZ" for Kazakhstan. 747 -|departureCityUID|String (UUID)|No|The unique identifier of the departure city. This is a UUID, such as "f0ba6324-f337-405c-8cc7-23d62cf664e8". 748 -|arrivalCountryCode|String|No|The ISO 3166-1 alpha-2 code of the arrival country. For example, "AE" for United Arab Emirates. 749 -|adults|Integer|No|The number of adults for the trip. For example, 2 for two adults. 750 -|children|Integer|No|The number of children for the trip. For example, 0 for no children. 751 -|departureDate|String (date-time)|No|The departure date in ISO 8601 format. For example, "2024-05-25T00:00:00" for May 25, 2024. 752 -|returnDate|String (date-time)|No|The return date in ISO 8601 format. For example, "2024-06-01T00:00:00" for June 1, 2024. 753 -|departureAndReturnDaysCount|Integer|No|The total number of days for the departure and return trip. For example, 7 for a week-long trip. 754 -|checkInDate|String (date-time)|No|The check-in date at the hotel in ISO 8601 format. For example, "2024-05-25T00:00:00" for May 25, 2024. 755 -|checkOutDate|String (date-time)|No|The check-out date from the hotel in ISO 8601 format. For example, "2024-06-01T00:00:00" for June 1, 2024. 756 -|checkInAndCheckOutDaysCount|Integer|No|The total number of days for the hotel stay. For example, 7 for a week-long stay. 757 -|directFlightsOnly|Boolean|No|Whether to search for direct flights only. For example, true to only search for direct flights. 758 -|pageRowCount|Integer|No|The number of results to return per page. For example, 1 to return 1 result per page. 759 -|searchCurrency|String|No|The currency in which the search results should be displayed. For example, "USD" for United States Dollar. 767 +|=Field|=Type|=Description 768 +|departureCountryCode|string|The ISO 3166-1 alpha-2 country code for the departure country. For example, "KZ" for Kazakhstan. 769 +|departureCityUID|string|The unique identifier for the departure city. 770 +|arrivalCountryCode|string|The ISO 3166-1 alpha-2 country code for the arrival country. For example, "AE" for United Arab Emirates. 771 +|arrivalLocations|array|An array of objects, each representing an arrival location. Each object contains: type (string) - The type of the location. This can be "city". label (string) - The name of the location. value (string) - The unique identifier for the location. tag (string) - A tag for the location. 772 +|checkInDate|string|The check-in date in ISO 8601 format. 773 +|checkInDateTo|string|The latest possible check-in date in ISO 8601 format. 774 +|stayDays|integer|The minimum number of days to stay. 775 +|stayDaysTo|integer|The maximum number of days to stay. 776 +|airlineCode|string|The code of the airline. This field can be empty. 777 +|ticketType|string|The type of the ticket. This field can be empty. 778 +|directFlightsOnly|boolean|Indicates whether to search for direct flights only. 779 +|longConnectTime|boolean|Indicates whether to include flights with long connection times. 780 +|adults|integer|The number of adults. 781 +|children|integer|The number of children. 782 +|childrenAges|array|An array of integers, each representing the age of a child. 783 +|extendedSearch|boolean|Indicates whether to perform an extended search. 784 +|totalPriceFrom|float|The minimum total price. 785 +|totalPriceTo|float|The maximum total price. 786 +|recommended|boolean|Indicates whether to include recommended packages. 787 +|popular|boolean|Indicates whether to include popular packages. 788 +|freeSale|boolean|Indicates whether to include free sale packages. 789 +|groupByHotel|boolean|Indicates whether to group the results by hotel. 790 +|hotelCodes|array|An array of strings, each representing a hotel code. This field can be empty. 791 +|mealPlans|array|An array of meal plans. This field can be empty. 792 +|hotelClasses|array|An array of hotel classes. This field can be empty. 793 +|hotelTypes|array|An array of hotel types. This field can be empty. 794 +|hotelServices|array|An array of hotel services. This field can be empty. 795 +|pagingId|string|The paging ID for paginated results. This field can be empty. 796 +|pageNumber|integer|The page number for paginated results. 797 +|pageRowCount|integer|The number of rows per page for paginated results. 760 760 761 -=== === 799 +(% class="wikigeneratedid" %) 800 +**Response Parameters** 762 762 763 -=== **Response Parameters** === 764 - 765 765 (% class="table-bordered" %) 766 -|=Key|=Type|=Description 767 -|packages|Array|An array of travel packages. Each package includes various details about the package. 768 -|packages[].id|String|A unique identifier for the package. This is used to uniquely identify each package. 769 -|packages[].priceCurrency|String|The currency in which the price is denoted. This could be USD, EUR, etc. 770 -|packages[].totalPrice|Number|The total price of the package. This includes all costs associated with the package. 771 -|packages[].agentCommissionPercent|Number|The commission percentage for the agent. This is the percentage of the total price that the agent receives as commission. 772 -|packages[].agentCommissionAmount|Number|The commission amount for the agent. This is the actual amount the agent receives as commission. 773 -|packages[].includedExtrasAmount|Number|The amount for the included extras. This is the cost of any extra services included in the package. 774 -|packages[].priceDifference|Number|The price difference. This could be a discount or a price increase. 775 -|packages[].hotel|Object|An object containing details about the hotel included in the package. This includes information like the hotel name, class, availability, etc. 776 -|packages[].hotel.hotelPriceId|String|The price ID of the hotel. This is used to uniquely identify the price for the hotel. 777 -|packages[].hotel.hotelName|String|The name of the hotel. This is the actual name of the hotel. 778 -|packages[].hotel.hotelCode|String|The code of the hotel. This is a unique code used to identify the hotel. 779 -|packages[].hotel.nights|Number|The number of nights for the stay. This is the duration of the stay at the hotel. 780 -|packages[].hotel.mealPlan|String|The meal plan for the stay. This could be breakfast included, all inclusive, etc. 781 -|packages[].hotel.hotelClass|String|The class of the hotel. This could be 3-star, 4-star, 5-star, etc. 782 -|packages[].hotel.hotelColor|String|The color associated with the hotel. This could be used for categorization or visualization purposes. 783 -|packages[].hotel.availabilityType|String|The availability type of the hotel. This could be available, sold out, etc. 784 -|packages[].hotel.availableRoomsCount|Number|The count of available rooms. This is the number of rooms that are currently available at the hotel. 785 -|packages[].hotel.fewRooms|Boolean|A boolean indicating if there are few rooms left. If true, it means that there are only a few rooms left. 786 -|packages[].hotel.roomCategoryCode|String|The code of the room category. This is a unique code used to identify the room category. 787 -|packages[].hotel.roomCategoryName|String|The name of the room category. This is the actual name of the room category. 788 -|packages[].hotel.placementTypeName|String|The name of the placement type. This could be sea view, garden view, etc. 789 -|packages[].hotel.placementDescription|String|The description of the placement. This provides more details about the placement type. 790 -|packages[].hotel.checkInDate|String|The check-in date. This is the date when the stay at the hotel begins. 791 -|packages[].hotel.checkOutDate|String|The check-out date. This is the date when the stay at the hotel ends. 792 -|packages[].hotel.adults|Number|The number of adults. This is the number of adults that will be staying at the hotel. 793 -|packages[].hotel.children|Number|The number of children. This is the number of children that will be staying at the hotel. 794 -|packages[].hotel.districtUID|String|The UID of the district. This is a unique identifier for the district where the hotel is located. 795 -|packages[].hotel.districtName|String|The name of the district. This is the actual name of the district where the hotel is located. 796 -|packages[].hotel.cityUID|String|The UID of the city. This is a unique identifier for the city where the hotel is located. 797 -|packages[].hotel.cityName|String|The name of the city. This is the actual name of the city where the hotel is located. 798 -|packages[].hotel.countryCode|String|The code of the country. This is a unique code used to identify the country where the hotel is located. 799 -|packages[].hotel.countryName|String|The name of the country. This is the actual name of the country where the hotel is located. 800 -|packages[].hotel.hasAlcohol|Boolean|A boolean indicating if alcohol is available. If true, it means that alcohol is available at the hotel. 801 -|packages[].hotel.hasFreeWifi|Boolean|A boolean indicating if free Wi-Fi is available. If true, it means that free Wi-Fi is available at the hotel. 802 -|packages[].hotel.hasMetro|Boolean|A boolean indicating if metro is available. If true, it means that there is a metro station near the hotel. 803 -|packages[].hotel.hasPool|Boolean|A boolean indicating if a pool is available. If true, it means that the hotel has a pool. 804 -|packages[].hotel.hasMall|Boolean|A boolean indicating if a mall is available. If true, it means that there is a mall near the hotel. 805 -|packages[].hotel.infantMaxAge|Number|The maximum age for an infant. This is the maximum age at which a person is considered an infant. 806 -|packages[].hotel.childMinAge|Number|The minimum age for a child. This is the minimum age at which a person is considered a child. 807 -|packages[].hotel.childMaxAge|Number|The maximum age for a child. This is the maximum age at which a person is considered a child. 808 -|packages[].hotel.teenMinAge|Number|The minimum age for a teen. This is the minimum age at which a person is considered a teen. 809 -|packages[].hotel.teenMaxAge|Number|The maximum age for a teen. This is the maximum age at which a person is considered a teen. 810 -|packages[].hotel.adultMinAge|Number|The minimum age for an adult. This is the minimum age at which a person is considered an adult. 811 -|packages[].hotel.cancellationPolicyDescription|String|The description of the cancellation policy. This provides more details about the cancellation policy of the hotel. 812 -|packages[].hotel.cancellationPolicy|Object|An object containing details about the cancellation policy. This includes information like the cancellation deadline, cancellation fee, etc. 813 -|packages[].flight|Object|An object containing details about the flight included in the package. This includes information like the flight ID, departure date, return date, etc. 814 -|packages[].flight.id|String|The ID of the flight. This is used to uniquely identify the flight. 815 -|packages[].flight.departureDate|String|The departure date of the flight. This is the date when the flight departs. 816 -|packages[].flight.returnDate|String|The return date of the flight. This is the date when the flight returns. 817 -|packages[].flight.departureTicketsLeft|Number|The number of departure tickets left. This is the number of tickets that are still available for the departure flight. 818 -|packages[].flight.returnTicketsLeft|Number|The number of return tickets left. This is the number of tickets that are still available for the return flight. 819 -|packages[].flight.departureAvailabilityType|String|The availability type of the departure flight. This could be available, sold out, etc. 820 -|packages[].flight.returnAvailabilityType|String|The availability type of the return flight. This could be available, sold out, etc. 821 -|packages[].flight.isTwoWay|Boolean|A boolean indicating if the flight is two-way. If true, it means that the flight includes both departure and return. 822 -|packages[].flight.sameBaggageForAll|Boolean|A boolean indicating if the same baggage is for all. If true, it means that the same baggage allowance applies to all passengers. 823 -|packages[].flight.totalBaggage|Boolean|A boolean indicating if total baggage is included. If true, it means that the total baggage allowance is included in the price. 824 -|packages[].flight.isBlock|Boolean|A boolean indicating if the flight is blocked. If true, it means that the flight is currently blocked and cannot be booked. 825 -|packages[].flight.class|String|The class of the flight. This could be economy, business, first class, etc. 826 -|packages[].flight.departureSegments|Array|An array containing details about the departure segments. Each segment includes information like the departure airport, arrival airport, departure time, arrival time, etc. 827 -|packages[].flight.returnSegments|Array|An array containing details about the return segments. Each segment includes information like the departure airport, arrival airport, departure time, arrival time, etc. 828 -|packages[].flight.passengers|Array|An array containing details about the passengers. Each passenger includes information like the passenger type, baggage allowance, etc. 829 -|packages[].extraServices|Array|An array of any extra services included in the package. Each service includes information like the service name, service price, etc. 830 -|packages[].insurancePrice|Object|An object containing details about the insurance price included in the package. This includes information like the insurance type, insurance price, etc. 831 -|packages[].cacheKey|String|The cache key. This is used to cache the package details for faster retrieval. 832 -|packages[].sortCheckInOut|String|The check-in and check-out dates for sorting. This is used to sort the packages based on the check-in and check-out dates. 833 -|packages[].sortAirline|String|The airline for sorting. This is used to sort the packages based on the airline. 834 -|packages[].sortHotelName|String|The hotel name for sorting. This is used to sort the packages based on the hotel name. 835 -|packages[].sortDetails|String|The details for sorting. This is used to sort the packages based on various details. 836 -|packages[].sortPlacement|String|The placement for sorting. This is used to sort the packages based on the placement. 837 -|pagingId|String|An identifier for the page. This is used to uniquely identify each page of results. 838 -|pageNumber|Number|The current page number. This is the number of the current page of results. 839 -|pageCount|Number|The total number of pages. This is the total number of pages of results. 840 -|totalCount|Number|The total count of packages. This is the total number of packages in all pages of results. 841 -|error|Boolean|A boolean indicating whether there was an error. If true, it means that there was an error in retrieving the packages. 803 +|=Field|=Type|=Description 804 +|packages|array|An array of packages available. Each package contains: 805 +|cacheKey|string|A unique identifier for the cache. 806 +|id|string|A unique identifier for the package. 807 +|priceCurrency|string|The currency in which the price is displayed. 808 +|totalPrice|float|The total price of the package. 809 +|agentCommissionPercent|float|The commission percentage for the agent. 810 +|agentCommissionAmount|float|The commission amount for the agent. 811 +|includedExtrasAmount|integer|The amount of extras included in the package. 812 +|priceDifference|integer|The difference in price from the original price. 813 +|hotel|object|An object containing details about the hotel. 814 +|hotelPriceId|string|A unique identifier for the hotel price. 815 +|providerId|integer|A unique identifier for the provider. 816 +|hotelName|string|The name of the hotel. 817 +|hotelCode|string|A unique code for the hotel. 818 +|nigths|integer|The number of nights for the stay. 819 +|mealPlan|string|The meal plan for the stay. 820 +|hotelClass|string|The class or rating of the hotel. 821 +|availabilityType|string|The availability type of the hotel. 822 +|availableRoomsCount|integer|The number of available rooms in the hotel. 823 +|fewRooms|boolean|Indicates whether there are few rooms left. 824 +|roomCategoryCode|string|A unique code for the room category. 825 +|roomCategoryName|string|The name of the room category. 826 +|placementTypeName|string|The name of the placement type. 827 +|checkInDate|string|The check-in date in ISO 8601 format. 828 +|checkOutDate|string|The check-out date in ISO 8601 format. 829 +|adults|integer|The number of adults for the stay. 830 +|children|integer|The number of children for the stay. 831 +|districtUID|string|A unique identifier for the district. 832 +|districtName|string|The name of the district. 833 +|cityUID|string|A unique identifier for the city. 834 +|cityName|string|The name of the city. 835 +|countryCode|string|The ISO 3166-1 alpha-2 country code. 836 +|countryName|string|The name of the country. 837 +|hasAlcohol|boolean|Indicates whether the hotel serves alcohol. 838 +|hasFreeWifi|boolean|Indicates whether the hotel offers free Wi-Fi. 839 +|hasMetro|boolean|Indicates whether the hotel is near a metro station. 840 +|hasPool|boolean|Indicates whether the hotel has a pool. 841 +|hasMall|boolean|Indicates whether the hotel is near a shopping mall. 842 +|cancellationPolicyDescription|string|The description of the cancellation policy. 843 +|cancellationPolicy|object|An object containing details about the cancellation policy. 844 +|flight|object|An object containing details about the flight. 845 +|id|string|A unique identifier for the flight. 846 +|departureDate|string|The departure date in ISO 8601 format. 847 +|returnDate|string|The return date in ISO 8601 format. 848 +|departureTicketsLeft|integer|The number of departure tickets left. 849 +|returnTicketsLeft|integer|The number of return tickets left. 850 +|departureAvailabilityType|string|The availability type of the departure flight. 851 +|returnAvailabilityType|string|The availability type of the return flight. 852 +|isTwoWay|boolean|Indicates whether the flight is two-way. 853 +|sameBaggageForAll|boolean|Indicates whether the same baggage is applicable for all passengers. 854 +|totalBaggage|boolean|Indicates whether total baggage is included. 855 +|departureSegments|array|An array of objects, each representing a departure segment. 856 +|returnSegments|array|An array of objects, each representing a return segment. 857 +|passengers|array|An array of objects, each representing a passenger. 858 +|extraServices|array|An array of extra services included in the package. 859 +|insurancePrice|object|An object containing details about the insurance price. 860 +|pagingId|string|The paging ID for paginated results. 861 +|pageNumber|integer|The page number for paginated results. 862 +|pageCount|integer|The total number of pages. 863 +|totalCount|integer|The total count of packages. 864 +|error|boolean|Indicates whether there was an error. 842 842 866 +=== Paging and Caching === 867 + 868 +During the first request, Paging id must be empty like this ( "pagingId": "",) pagenumber is the number of the page, pagerowcount means number of the given result in one page. So in the first request we can search like this: 869 + 870 + 843 843 ==== first request ==== 844 844 845 845 {{code language="Json"}}