openapi: 3.0.3
info:
  title: ITT Hotel API
  version: 1.0.0
  description: Hotel API endpoints converted from Postman collection.

servers:
  - url: "{protocol}://{fullUrl}"
    description: Dynamic Server Selection
    variables:
      protocol:
        enum:
          - https
          - http
        default: https
      fullUrl:
        default: serviceapi.tripapi.site
        description: Full URL of the server, e.g., serviceapi.example.com or localhost:8080

tags:
  - name: Hotel
    description: Hotel search, pricing, booking, ancillaries and post-booking flows.

security:
  - apiKeyAuth: []
    secretCodeAuth: []
paths:

  /hotel/auto-suggetion:
    post:
      tags: 
      - Hotel Search & Pricing
      summary: Get auto-suggestions for hotel search locations
      operationId: hotelAutoSuggestion
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                    type: string
                    description: Location name or partial name for hotel autocomplete/search
                    example: "paris"
              additionalProperties: true
            examples:
              default:
                value:
                  location: paris
      responses:
        '200':
          description: Suggested locations and entities for hotel search
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_suggestion:
                  summary: Successful Auto-suggestion Response
                  value:
                      - location: "Paris, France"
                      - location: "Paris, TX, USA"
                      - location: "Paris Expo Porte de Versailles, Place de la Porte de Versailles, Paris, France"
                      - location: "Paris Las Vegas, South Las Vegas Boulevard, Las Vegas, NV, USA"
                      - location: "Paris Orly Airport (ORY), Orly, France"

                invalid_location_length:
                  summary: Location name too short
                  value:
                    status: "failed"
                    reason: "Location name must be more than 4 characters"

        
        
  /hotel/search:
    post:
      tags: 
      - Hotel Search & Pricing
      summary: hotel search by location and occupancies
      operationId: hotelSearchGeneral
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - location
              - partner_id
              - checkIn
              - checkOut
              - occupancies
              properties:
                location:
                  type: string
                  description: Hotel search location
                  example: "Dubai - United Arab Emirates"

                partner_id:
                  type: string
                  description: Partner account ID
                  example: "1"

                guest_nationality:
                  type: string
                  description: Nationality of the guest (ISO country code)
                  example: "BD"

                supplier_uid:
                  type: string
                  description: Supplier unique ID (optional)
                  example: "H1AS00029"

                checkIn:
                  type: string
                  format: date
                  description: Check-in date (YYYY-MM-DD)
                  example: "2025-07-09"

                checkOut:
                  type: string
                  format: date
                  description: Check-out date (YYYY-MM-DD)
                  example: "2025-07-10"

                radius:
                  type: string
                  description: Search radius around location (e.g., auto / 5km)
                  example: "auto"

                breakfast_option:
                  type: string
                  description: Breakfast preference filter (any / included / excluded)
                  example: "any"

                hotel_star_level:
                  type: string
                  description: Filter by hotel star rating (any / 3 / 4 / 5)
                  example: "any"
                occupancies:
                    type: object
                    required:
                      - adult
                    properties:
                      adult:
                        type: string
                        description: Number of adults in the room
                        example: "2"
                      child:
                        type: string
                        description: Number of children in the room
                        example: "1"
                      child_age:
                        type: array
                        description: Ages of children (if any)
                        items:
                          type: string
                          example: "3"
                      short_ref:
                          type: string
                          description: Short reference ID for tracking (optional)
                          example: "b1da9390..."
                                                  


              additionalProperties: true
            examples:
              dubaiFamily:
                value:
                  location: Dubai - United Arab Emirates
                  partner_id: "1"
                  guest_nationality: BD
                  supplier_uid: H1AS00029
                  checkIn: 2025-07-09
                  checkOut: 2025-07-10
                  radius: auto
                  breakfast_option: any
                  hotel_star_level: any
                  occupancies:
                    - adult: "2"
                      child: "1"
                      child_age: ["3"]
                    - adult: "2"
                  short_ref: b1da9390...
              bangkokExample:
                value:
                  location: bangkok
                  radius: auto
                  checkIn: 2024-06-11
                  checkOut: 2024-06-12
                  occupancies:
                    - adult: "2"
                      child: "2"
                      child_age: ["5", "0"]
                    - adult: "2"
                  guest_nationality: SG
                  hotel_star_level: any
                  search_currency: any
                  supplier_uid: H1AL00013
                  partner_id: "1"
                  language: en
      responses:
        '200':
          description: Hotel search results response
          content:
            application/json:
              schema:
               type: object
               additionalProperties: true
              examples:
                successful_hotel_search:
                  summary: Successful hotel search response
                  value:
              
                        "status": "success"
                        "reason": "Your destination search yielded results for 194 hotels."
                        "tracking_id": "11177173317126194WKNKI"
                        "search_duration_seconds": "42 seconds"
                        "search_total_block": 24,
                        "search_total_hotel": 1741,
                        "total_hotel": 194,
                        "before_mapping_total_hotel": 233,
                        "name_match_mapping_addon": null,
                        "ResultPercentage": "0.00%"
                        "search_parameter":
                              "tracking_id": "11771733169CCL1"
                              "location": "Dhaka, Bangladesh"
                              "radius": "auto"
                              "search_radius": 17,
                              "unit": "km"
                              "checkIn": "2026-03-15"
                              "checkOut": "2026-03-21"
                              "total_night": "6"
                              "total_room": 1,
                              "total_adult": 2,
                              "total_child": 0,
                              "occupancies": 
                                   {
                                    "room": 1,
                                    "adult": "2",
                                    "child": "0"
                                  }
                              "guest_nationality": "BD"
                              "hotel_star_level": "any"
                              "search_currency": null,
                              "latitude": 23.804093,
                              "longitude": 90.4152376,
                              "country_name": "Bangladesh"
                              "country_code": "BD"
                              "city_name": "Dhaka"
                              "city_code": "Dhaka"
                              "area_name": null,
                              "area_code": null,
                              "supplier_uid": "all"
                              "hotel_mapping_count": 1792
                        "data":
                              "uid": 36,
                              "hotel_id": "H1EA00004#17350009"
                              "vervotechId": "15712948"
                              "giataId": "725793"
                              "tracking_id": "11771733169CCL1"
                              "room_tracking_id": "11771733169CCL1-H1EA00004-36"
                              "hotel_name": "White House Guest House"
                              "hotel_name_code": "white-house-guest-house"
                              "property_type": "Guesthouse"
                              "room_title": "Dormitory Room"
                              "promo_tag": "Save:7%"
                              "rate_type": "Bed-Breakfast"
                              "star_rating": 3,
                              "rating_average": null,
                              "primary_photo": "https://i.travelapi.com/lodging/18000000/17360000/17350100/17350009/ec5cf8b2_z.jpg"
                              "address": "10B/1, Road 51, Unit B1, Gulshan 2"
                              "latitude": "23.8011"
                              "longitude": "90.4145"
                              "distance_km": "0.34116"
                              "currency": "BDT"
                              "total_amount": 28180.83,
                              "sell_price": 28180.83,
                              "sell_per_night": 28180.83,
                              "supplier": {
                                  "supplier_code": "ean",
                                  "supplier_uid": "H1EA00004",
                                  "supplier_partner_code": "ean-1-00004",
                                  "currency": "USD",
                                  "purchase": 231.12,
                                  "fmg_price": 231.12
                              }
                              "free_cancellation": 36,
                              "facility": [
                                  {
                                      "title": "Breakfast",
                                      "icon": "mdi mdi-coffee"
                                  },
                                  {
                                      "title": "Wifi",
                                      "icon": "mdi mdi-wifi"
                                  },
                                  {
                                      "title": "Restaurant",
                                      "icon": "mdi mdi-silverware-fork-knife"
                                  },
                                  {
                                      "title": "Airport transfer",
                                      "icon": "mdi mdi-car-arrow-right"
                                  },
                                  {
                                      "title": "Laundry service",
                                      "icon": "mdi mdi-washing-machine-alert"
                                  },
                                  {
                                      "title": "Luggage storage",
                                      "icon": "mdi mdi-bag-checked"
                                  },
                                  {
                                      "title": "Swimming pool",
                                      "icon": "mdi mdi-pool"
                                  },
                                  {
                                      "title": "Fitness center",
                                      "icon": "mdi mdi-dumbbell"
                                  },
                                  {
                                      "title": "Car Parking",
                                      "icon": "mdi mdi-parking"
                                  }
                              ]
                              "search_result_logs_url": "https://temp-logs.example.com/hotel_logs/11177173317126194WKNKI/search_result.json"

                invalid_checkin_date:
                  summary: Invalid Check-In Date
                  value:
                    status: "failed"
                    reason: "You need to provide a current or future Check-In Date"

                authorization_failed:
                  summary: Authorization Failed (Warning)
                  value:
                    status: "failed"
                    is_warning: "yes"
                    reason: "You do not have authorization to book through . Please reach out to the Support team for assistance."
                    reason_admin: " Book Hotel is Disable"

                            
        

  /hotel/rooms:
    post:
      tags: 
      - Hotel Search & Pricing
      summary: Single Hotel availability for a specific hotel and room.
      operationId: hotelRooms
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - hotel_id
              - checkIn
              - checkOut
              - occupancies
              properties:

                hotel_id:
                  type: string
                  description: Unique hotel identifier
                  example: "H1EA00004#17350009"

                checkIn:
                  type: string
                  format: date
                  description: Check-in date in YYYY-MM-DD format
                  example: "2026-03-15"

                checkOut:
                  type: string
                  format: date
                  description: Check-out date in YYYY-MM-DD format
                  example: "2026-03-16"

                occupancies:
                  type: array
                  description: Room occupancies
                  items:
                    type: object
                    required:
                      - adult
                    properties:
                      adult:
                        type: string
                        description: Number of adults in the room
                        example: "2"
                      child:
                        type: string
                        description: Number of children (optional)
                        example: "1"
                      child_age:
                        type: array
                        description: Ages of children (if any)
                        items:
                          type: string
                          example: "3"

                guest_nationality:
                  type: string
                  description: Nationality of guest (ISO country code)
                  example: "BD"
              additionalProperties: true
            examples:
              default:
                value:
                  hotel_id: H1AS00029#RTPARDAM#PAR
                  checkIn: 2025-07-02
                  checkOut: 2025-07-03
                  occupancies:
                    - adult: "2"
                  guest_nationality: BD
      responses:
        '200':
          description: Hotel availability and pricing for the hotel.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_hotel_rooms:
                  summary: Successful Hotel Availability Search Response.
                  value:
                    
                            {
                            "status": "success",
                            "tracking_id": "11170398842026238CWCML",
                            "search_parameter": {
                                "hotel_id": "H10004#770081",
                                "checkIn": "2024-02-11",
                                "checkOut": "2024-02-12",
                                "occupancies": [
                                    {
                                        "adult": "1"
                                    }
                                ],
                                "guest_nationality": "SG",
                                "total_night": "1"
                            },
                            "session_expire": {
                                "timestamp": 1703990222,
                                "datetime": "2023-12-31 10:37:02 +08",
                                "message": "The booking process should be completed by no later than 2023-12-31 10:37:02 +08."
                            },
                            "response_data": [
                                {
                                    "tracking_id": "11170398842026238CWCML",
                                    "room_tracking_id": "11170398842026238CWCML-hotelbeds-0",
                                    "supplier_partner_code": "hotelbeds-1-0004",
                                    "supplier_code": "hotelbeds",
                                    "total_amount": 77.77,
                                    "sell_total_price": 77.77,
                                    "currency": "USD",
                                    "sales_comission": null,
                                    "customer_markup_policy": {
                                        "Id": "2",
                                        "ftm_partner_id": "1",
                                        "partner_name": null,
                                        "supplier_type": "HOTEL",
                                        "on_base_fare_ratio_markup": "0.00",
                                        "on_base_fare_ratio_discount": "0.00",
                                        "on_base_fare_fixed_markup": "0.00",
                                        "on_tax_ratio_markup": "0.00",
                                        "on_tax_fixed_markup": "0.00",
                                        "cancellation_buffer_days": "0",
                                        "ssr_charge_ratio": "0.00",
                                        "ssr_charge_markup": "0.00",
                                        "timestamp": null,
                                        "last_update": null,
                                        "markup_min_active": "disable",
                                        "markup_min": "0.00",
                                        "markup_max_active": "disable",
                                        "markup_max": "0.00",
                                        "ticket_issue_charge": "0.00",
                                        "penalty_markup": "0.00"
                                    },
                                    "data": [
                                        {
                                            "uid": 0,
                                            "room_id": "SUI.DX-KG",
                                            "room_name": "Deluxe King Suite",
                                            "hotel_id": 770081,
                                            "supplier": "hotelbeds",
                                            "hold_possible": "yes",
                                            "rate_id": "20240211|20240212|W|321|770081|SUI.DX-KG|GC-ALL|RO||1~1~0||N@06~~2226a~1868699188~N~~~NOR~BD45516EE9C545C170398842092100AASG000000100000000052226a",
                                            "rate_code": "RO",
                                            "rate_type": "ROOM ONLY",
                                            "rate_class": "NOR",
                                            "availability": "BOOKABLE",
                                            "available_rooms": 2,
                                            "refundable": null,
                                            "occupancies": {
                                                "total_room": 1,
                                                "total_guest": 1,
                                                "adults": 1,
                                                "children": 0
                                            },
                                            "amenities": null,
                                            "amenities_list": [
                                                ""
                                            ],
                                            "price": 77.77,
                                            "sell": 77.77,
                                            "currency": "USD",
                                            "price_breakdown": {
                                                "total": {
                                                    "purchase": {
                                                        "price": 77.77,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 77.77,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 106.34,
                                                        "currency": "SGD"
                                                    },
                                                    "supplier": {
                                                        "price": "106.34",
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "base_fare": {
                                                    "purchase": {
                                                        "price": 77.77,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 77.77,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 106.34,
                                                        "currency": "SGD"
                                                    },
                                                    "supplier": {
                                                        "price": "106.34",
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "tax": {
                                                    "purchase": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    },
                                                    "buy": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "stay_tax": {
                                                    "purchase": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": null,
                                                        "currency": "SGD"
                                                    },
                                                    "buy": {
                                                        "price": null,
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "extra_person_fee": {
                                                    "purchase": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    },
                                                    "buy": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    }
                                                }
                                            },
                                            "bed": {
                                                "bed_type": "1 King Bed",
                                                "bed_icon": "bed.svg",
                                                "bed_type_guarantee": ""
                                            },
                                            "cancellation_policies": {
                                                "auto_cancel": "2023-12-31T10:07:02+08:00",
                                                "summery": "non refundable",
                                                "cancellation_buffer_days": "0"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "tracking_id": "11170398842026238CWCML",
                                    "room_tracking_id": "11170398842026238CWCML-hotelbeds-1",
                                    "supplier_partner_code": "hotelbeds-1-0004",
                                    "supplier_code": "hotelbeds",
                                    "total_amount": 83.75,
                                    "sell_total_price": 83.75,
                                    "currency": "USD",
                                    "sales_comission": null,
                                    "customer_markup_policy": {
                                        "Id": "2",
                                        "ftm_partner_id": "1",
                                        "partner_name": null,
                                        "supplier_type": "HOTEL",
                                        "on_base_fare_ratio_markup": "0.00",
                                        "on_base_fare_ratio_discount": "0.00",
                                        "on_base_fare_fixed_markup": "0.00",
                                        "on_tax_ratio_markup": "0.00",
                                        "on_tax_fixed_markup": "0.00",
                                        "cancellation_buffer_days": "0",
                                        "ssr_charge_ratio": "0.00",
                                        "ssr_charge_markup": "0.00",
                                        "timestamp": null,
                                        "last_update": null,
                                        "markup_min_active": "disable",
                                        "markup_min": "0.00",
                                        "markup_max_active": "disable",
                                        "markup_max": "0.00",
                                        "ticket_issue_charge": "0.00",
                                        "penalty_markup": "0.00"
                                    },
                                    "data": [
                                        {
                                            "uid": 1,
                                            "room_id": "DBL.DX-GD",
                                            "room_name": "Grand Deluxe King Suite",
                                            "hotel_id": 770081,
                                            "supplier": "hotelbeds",
                                            "hold_possible": "yes",
                                            "rate_id": "20240211|20240212|W|321|770081|DBL.DX-GD|GC-ALL|RO||1~1~0||N@06~~23472~-1518448322~N~~~NOR~BD45516EE9C545C170398842092100AASG0000001000000000523472",
                                            "rate_code": "RO",
                                            "rate_type": "ROOM ONLY",
                                            "rate_class": "NOR",
                                            "availability": "BOOKABLE",
                                            "available_rooms": 2,
                                            "refundable": null,
                                            "occupancies": {
                                                "total_room": 1,
                                                "total_guest": 1,
                                                "adults": 1,
                                                "children": 0
                                            },
                                            "amenities": null,
                                            "amenities_list": [
                                                ""
                                            ],
                                            "price": 83.75,
                                            "sell": 83.75,
                                            "currency": "USD",
                                            "price_breakdown": {
                                                "total": {
                                                    "purchase": {
                                                        "price": 83.75,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 83.75,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 114.52,
                                                        "currency": "SGD"
                                                    },
                                                    "supplier": {
                                                        "price": "114.52",
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "base_fare": {
                                                    "purchase": {
                                                        "price": 83.75,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 83.75,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 114.52,
                                                        "currency": "SGD"
                                                    },
                                                    "supplier": {
                                                        "price": "114.52",
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "tax": {
                                                    "purchase": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    },
                                                    "buy": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "stay_tax": {
                                                    "purchase": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": null,
                                                        "currency": "SGD"
                                                    },
                                                    "buy": {
                                                        "price": null,
                                                        "currency": "SGD"
                                                    }
                                                },
                                                "extra_person_fee": {
                                                    "purchase": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "sell": {
                                                        "price": 0,
                                                        "currency": "USD"
                                                    },
                                                    "fmg": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    },
                                                    "buy": {
                                                        "price": 0,
                                                        "currency": "SGD"
                                                    }
                                                }
                                            },
                                            "bed": {
                                                "bed_type": "1 King Bed",
                                                "bed_icon": "bed.svg",
                                                "bed_type_guarantee": ""
                                            },
                                            "cancellation_policies": {
                                                "auto_cancel": "2023-12-31T10:07:02+08:00",
                                                "summery": "non refundable",
                                                "cancellation_buffer_days": "0"
                                            }
                                        }
                                    ]
                                }
                            ]
                        }
                invalid_checkin_date:
                  summary: Invalid Check-In Date
                  value:
                    status: "failed"
                    reason: "You need to provide future or current Check-In Date"

                partner_validation_failed:
                  summary: Partner Search Target Validation Failed
                  value:
                    status: "failed"
                    reason: "The validation for the source of the partner search target has failed. Please contact the administrator for assistance."


       
  /hotel/get-hotel-details:
    post:
      tags: 
      - Hotel Search & Pricing
      summary: Single hotel Details Content.
      operationId: hotel Details Content
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                  - hotel_id
              properties:
                hotel_id:
                  type: string
                  description: Unique hotel identifier
                  example: "H1EA00004#17350009"
              additionalProperties: true
            examples:
              default:
                value:
                  hotel_id: H1AS00029#RTPARDAM#PAR
      responses:
        '200':
          description: Hotel Details Content Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_hotel_details:
                  summary: Successful Hotel Details Content Response
                  value:
                        "status": "success"
                        "hotel_id": "17350009"
                        "supplier_code": "ean"
                        "travelgate_supplier_code": ""
                        "last_update": "Saturday, 2025-04-26 9:54 PM +06:00"
                        "data": 
                            "created": "2025-04-26T15:54:10Z"
                            "timestamp": "1745682850"
                            "hotel_id": "17350009"
                            "name": "White House Guest House"
                            "name_local": "White House Guest House"
                            "hotel_formerly_name": "White House Guest House"
                            "brand_text": null,
                            "property_type": "Guesthouse"
                            "star_rating": "3.0"
                            "chain": "Independent"
                            "brand": "Independent"
                            "logo": null,
                            "primary_photo": "https://i.travelapi.com/lodging/18000000/17360000/17350100/17350009/ec5cf8b2_z.jpg"
                            "review_rating": 
                                "source": "Expedia.com"
                                "number_of_reviews": 2,
                                "rating_average": 362738,
                                "popularity_score": "1.0"
                            "policies": 
                                "checkin": 
                                    "begin_time": null,
                                    "end_time": "anytime"
                                    "instructions": "<ul>  <li>Extra-person charges may apply and vary depending on property policy</li><li>Government-issued photo identification and a credit card, debit card, or cash deposit may be required at check-in for incidental charges</li><li>Special requests are subject to availability upon check-in and may incur additional charges; special requests cannot be guaranteed</li><li>This property accepts credit cards</li><li>Only bookings from non-local guests are accepted; guests whose residence is within 50 mi (80 km) of the property will not be allowed to check in</li>  </ul>"
                                    "special_instructions": null,
                                    "min_age": 18
                                "checkout": {
                                        "time": "12:00 PM"
                                    }
                                "fees": {
                                        "optional": "<ul> <li>Airport shuttle fee: USD 20 per person (one-way)</li><li>Airport shuttle fee per child: USD 20.00</li></ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change. </p>"
                                        }
                                "know_before_you_go": null,
                                "pets": [
                                    "Pets not allowed"
                                ]
                                "remark": null,
                                "child_and_extra_bed_policy": {
                                    "infant_age": null,
                                    "children_age_from": null,
                                    "children_age_to": null,
                                    "children_stay_free": null,
                                    "min_guest_age": null
                                } 
                                "nationality_restrictions": null
                            "address": 
                              "latitude": 23.80112,
                              "longitude": 90.41445,
                              "address_line_1": "10B/1, Road 51, Unit B1, Gulshan 2"
                              "address_line_2": null,
                              "city": "Dhaka"
                              "state": null,
                              "country": "BD"
                              "country_code": "BD"
                              "postal_code": "1212"
                              "full_address": "10B/1, Road 51, Unit B1, Gulshan 2 , Dhaka, , BD-1212"
                              "google_map_site_link": "http://maps.google.com/maps?q=10B/1+Road+51+Unit+B1+Gulshan+2++Dhaka++BD-1212"
                              "local_lang": {
                                  "latitude": 23.80112,
                                  "longitude": 90.41445,
                                  "address_line_1": "10B/1, Road 51, Unit B1, Gulshan 2",
                                  "address_line_2": null,
                                  "city": "Dhaka",
                                  "state": null,
                                  "country": "BD",
                                  "country_code": "BD",
                                  "postal_code": "1212",
                                  "full_address": "10B/1, Road 51, Unit B1, Gulshan 2 , Dhaka, , BD-1212",
                                  "google_map_site_link": "http://maps.google.com/maps?q=10B/1 Road 51 Unit B1 Gulshan 2  Dhaka  BD-1212"
                              }
                              "mapping": {
                                  "continent_id": null,
                                  "country_id": "BD",
                                  "province_id": null,
                                  "state_id": null,
                                  "city_id": null,
                                  "area_id": null
                              }
                              "contacts": {
                                  "phone_numbers": [
                                      "880 1711 871359",
                                      "880-1711-871359"
                                  ],
                                  "fax": null,
                                  "email_address": [
                                      "whitehousebd@hotmail.com"
                                  ],
                                  "website": null
                              }
                              "descriptions": 
                                  
                                      "title": "Headline"
                                      "text": "In Dhaka (Gulshan)"
                              "title": "Location"
                              "text": "With a stay at White House Guest House in Dhaka (Gulshan), you'll be within a 10-minute walk of United Hospital and Gulshan Ladies Park.  This guesthouse is 0.8 mi (1.3 km) from Embassy of Turkey and 0.8 mi (1.3 km) from Embassy of South Korea."

                              "room_type":
                                  {
                                      "room_id": "220511109",
                                      "title": "Single room Attach Bathroom",
                                      "title_lang": "Single room Attach Bathroom",
                                      "room_pic": null,
                                      "description": "<p><strong>1 Twin Bed</strong></p><p><b>Internet</b> - Free WiFi </p><p><b>Food & Drink</b> - Coffee/tea maker, shared/communal kitchen access,  24-hour room service, and free bottled water</p><p><b>Bathroom</b> - Private bathroom, bathtub or shower, free toiletries, and towels</p><p><b>Practical</b> - Safe, free newspaper, and desk</p><p><b>Comfort</b> - Climate-controlled air conditioning and daily housekeeping</p><p>Non-Smoking</p>",
                                      "max_allowed": {
                                          "total": 1,
                                          "adults": 1,
                                          "children": 0,
                                          "infant": "n/a"
                                      },
                                      "no_of_room": "n/a",
                                      "room_size": null,
                                      "bed_type": [
                                          {
                                              "description": "1 Twin Bed",
                                              "configuration": [
                                                  {
                                                      "quantity": 1,
                                                      "size": "Twin",
                                                      "type": "TwinBed"
                                                  }
                                              ],
                                              "max_extrabeds": "n/a"
                                          }
                                      ],
                                      "shared_bathroom": "n/a"
                                  }
                              "shared_bathroom": "n/a"
                              "views": [
                                  "Valley view"
                              ]
                            "amenities": 
                                          
                                              "type": "Dry cleaning/laundry service"
                                              "title": "Dry cleaning/laundry service"
                                              "icon": "mdi mdi-alpha-f-circle-outline"
                            "facilities": [
                                          {
                                              "type": "professional-property-host/manager",
                                              "title": "Professional property host/manager",
                                              "icon": "mdi mdi-alpha-f-circle-outline"
                                          },
                                          {
                                              "type": "no-cribs-(infant-beds)-available",
                                              "title": "No cribs (infant beds) available",
                                              "icon": "mdi mdi-alpha-f-circle-outline"
                                          }
                                      ]
                            "hotel_photo": 
                                          {
                                              "picture_id": 3,
                                              "title": "Primary Image",
                                              "url": "https://i.travelapi.com/lodging/18000000/17360000/17350100/17350009/ec5cf8b2_z.jpg"
                                          }
                            "point_of_interests": 
                                                  
                                                      "code": null,
                                                      "name": "International Convention City Bashundhara"
                                                  
                                                  
                            "train_stations": [
                                                  {
                                                      "code": "DAC",
                                                      "name": "Airport Railway Station"
                                                  }
                                              ]
                            "connected_locations": 
                                                  {
                                                      "code": null,
                                                      "name": "Dhaka"
                                                  }
                            "neighbourhoods": 
                                                {
                                                    "code": "DAC",
                                                    "name": "Kāmarpāra"
                                                }
                            "stadiums":
                                                    {
                                                        "code": null,
                                                        "name": "Bangladesh Army Stadium"
                                                    }
                hotel_id_required_error:
                  summary: Hotel ID Required Error
                  value:
                    status: "failed"
                    hotel_id: "HLMAD100"
                    supplier_code: null
                    travelgate_supplier_code: null
                    last_update: null
                    data:
                      status: "failed"
                      reason: "hotel_id data is required."
                                                  
                                          

                                  
       
        
  /hotel/validate:
    post:
      tags: 
      - Hotel Search & Pricing
      summary: Get Price and Policy validation validation details.
      operationId: hotelPricePolicyValidation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - tracking_id
                - room_tracking_id
              properties:

                tracking_id:
                  type: integer
                  description: Search tracking ID from hotel search response
                  example: 11171005026802720

                room_tracking_id:
                  type: string
                  description: Unique room tracking identifier
                  example: "11175108883326193VKD98-H1AS00029-0"

              additionalProperties: true
            examples:
              default:
                value:
                  tracking_id: 11171005026802719
                  room_tracking_id: 11175108883326193VKD98-H1AS00029-0
      responses:
        '200':
          description: Validation details for selected hotel room
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                default:
                  summary: Successful Price and Policy Validation Response
                  value:
                          "status": "success"
                          tracking_id: "11177174741026194FHMV2"
                          room_tracking_id: "11177174741026194FHMV2-H1TL00142-0"
                          booking_tracking_id: "111771747633261941E6VT"
                          price_change: "no-change"
                          search_price:
                              currency: "BDT"
                              amount: 10014.46
                          validation_price:
                              currency: "BDT"
                              amount: 10014.46
                          session_expire:
                              timestamp: 1771748533
                              datetime: "2026-02-22 14:22:13 +06"
                              message: "The booking process should be completed by no later than 2026-02-22 14:22:13 +06."
                          search_parameter:
                              hotel_id: "H1TL00142#KGB1097616"
                              checkIn: "2026-03-15"
                              checkOut: "2026-03-16"
                              total_night: "1"
                              total_room: 2
                              total_adult: 4
                              total_child: 0
                              occupancies:
                                - room: 1
                                  adult: "2"
                                  child: ""
                                - room: 2
                                  adult: "2"
                                  child: ""
                              guest_nationality: "BD"
                              country_code: null
                              supplement_key: null
                          data:
                                summery:
                                tracking_id: "11177174741026194FHMV2"
                                room_tracking_id: "11177174741026194FHMV2-H1TL00142-0"
                                hotel_id: "H1TL00142#KGB1097616"
                                title: "DOUBLE CLUB QUEEN BED"
                                room_category: "club-room"
                                room_category_name: "Club Room"
                                room_category_priority: 15
                                promo_price_tag: false
                                total_amount: 10014.46
                                sell_total_price: 10014.46
                                currency: "BDT"
                                sales_commission: 0
                                supplier:
                                  supplier_code: "travelrobothotel"
                                  supplier_uid: "H1TL00142"
                                  supplier_partner_code: "travelrobothotel-1-00142"
                                  currency: "TRY"
                                  purchase: 10014.46
                                  fmg_price: 10014.46
                                hold_possible: "no"
                                policies:
                                  summery: "non-refundable"
                                  auto_cancel: "2026-02-22T14:07:13"
                                  auto_cancel_timestamp: "1771747633"
                          data():
                                - room_number: "DOUBLE CLUB QUEEN BED"
                                  name: "DOUBLE CLUB QUEEN BED"
                                  rate_comments: ". Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00."
                                  rate_code: "RO"
                                  rate_type: "Room Only"
                                  info:
                                    available_room: null
                                    size: []
                                  occupancies:
                                    total_room: "1"
                                    adult: null
                                    child: null
                                  rate_data:
                                    RoomCode: "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246"
                                  price:
                                    promo_tag: null
                                    purchase:
                                      total:
                                        currency: "BDT"
                                        amount: 10014.46
                                        before_discount: 10014.46
                                        discount: 0
                                        point: 0
                                      price_breakdown:
                                        currency: "BDT"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        payable_at_property: []
                                    sell:
                                      total:
                                        currency: "BDT"
                                        amount: 10014.46
                                        gross_price: 10014.46
                                        platform_fees_or_extra_tax: 0
                                        point: 0
                                      price_breakdown:
                                        currency: "BDT"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        platform_fees_or_extra_tax: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        payable_at_property: []
                                    fmg:
                                      total:
                                        currency: "TRY"
                                        amount: 10014.46
                                      price_breakdown:
                                        currency: "TRY"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        base_fare_fmg_charge: 0
                                        membership_discount_percentige: 0
                                        membership_discount_amount: 0
                                        final_base_fare_fmg_charge: 0
                                        payable_at_property: []
                                    supplier:
                                      total:
                                        currency: "TRY"
                                        amount: 10014.46
                                      price_breakdown:
                                        currency: "TRY"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        sales_tax: 0
                                        property_fees: 0
                                        surcharges: 0
                                        service_charge: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        payable_at_property: []
                                  meal_option: []
                                  bed_option: []
                                  amenities: []
                                  cancellation_raw:
                                    - CurrencyCode: "TRY"
                                      EndDate: "2026-03-15T00:00:00"
                                      Id: 0
                                      PenaltyAmount: 10014.46
                                      PenaltyBuyAmount: 10014.46
                                      PolicyDescription: "Policy : penalty amount between 20.02.2026 19:59 - 15.03.2026 00:00 dates is 10,014.46 TRY"
                                      PolicyType: "Policy"
                                      RoomCode: "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246"
                                      StartDate: "2026-02-20T19:59:00"
                                  cancellation_policy:
                                    hold_possible: "no"
                                    summery: "non-refundable"
                                    auto_cancel: "2026-02-22T14:07:13"
                                    auto_cancel_timestamp: "1771747633"
                                    policy_breakdown: []
                                - room_number: "DOUBLE CLUB QUEEN BED"
                                  name: "DOUBLE CLUB QUEEN BED"
                                  rate_comments: ". Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00."
                                  rate_code: "RO"
                                  rate_type: "Room Only"
                                  info:
                                    available_room: null
                                    size: []
                                  occupancies:
                                    total_room: "1"
                                    adult: null
                                    child: null
                                  rate_data:
                                    RoomCode: "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@d6bfe6091b6a49a1b7942f51a39c6c8c"
                                  price:
                                    promo_tag: null
                                    purchase:
                                      total:
                                        currency: "BDT"
                                        amount: 10014.46
                                        before_discount: 10014.46
                                        discount: 0
                                        point: 0
                                      price_breakdown:
                                        currency: "BDT"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        payable_at_property: []
                                    sell:
                                      total:
                                        currency: "BDT"
                                        amount: 10014.46
                                        gross_price: 10014.46
                                        platform_fees_or_extra_tax: 0
                                        point: 0
                                      price_breakdown:
                                        currency: "BDT"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        platform_fees_or_extra_tax: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        payable_at_property: []
                                    fmg:
                                      total:
                                        currency: "TRY"
                                        amount: 10014.46
                                      price_breakdown:
                                        currency: "TRY"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        base_fare_fmg_charge: 0
                                        membership_discount_percentige: 0
                                        membership_discount_amount: 0
                                        final_base_fare_fmg_charge: 0
                                        payable_at_property: []
                                    supplier:
                                      total:
                                        currency: "TRY"
                                        amount: 10014.46
                                      price_breakdown:
                                        currency: "TRY"
                                        total: 10014.46
                                        base_fare: 10014.46
                                        tax: 0
                                        sales_tax: 0
                                        property_fees: 0
                                        surcharges: 0
                                        service_charge: 0
                                        extra_person_fee: 0
                                        supplier_sales_comission: null
                                        payable_at_property: []
                                  meal_option: []
                                  bed_option: []
                                  amenities: []
                                  cancellation_raw:
                                    - CurrencyCode: "TRY"
                                      EndDate: "2026-03-15T00:00:00"
                                      Id: 0
                                      PenaltyAmount: 10014.46
                                      PenaltyBuyAmount: 10014.46
                                      PolicyDescription: "Policy : penalty amount between 20.02.2026 19:59 - 15.03.2026 00:00 dates is 10,014.46 TRY"
                                      PolicyType: "Policy"
                                      RoomCode: "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@d6bfe6091b6a49a1b7942f51a39c6c8c"
                                      StartDate: "2026-02-20T19:59:00"
                                  cancellation_policy:
                                    hold_possible: "no"
                                    summery: "non-refundable"
                                    auto_cancel: "2026-02-22T14:07:13"
                                    auto_cancel_timestamp: "1771747633"
                                    policy_breakdown: []
                                    post_booking_process: "auto"
                                    book_now_pay_later: "no"
                validation_expired_error:
                  summary: Room Tracking ID Invalid or Expired
                  value:
                    status: "failed"
                    reason: "Validation failed. The room tracking ID is either invalid or has expired."
                    data: null

     
       
  /hotel/validation-price-get-detail:
    post:
      tags: 
      - Hotel Search & Pricing
      summary: Get Get-Price validation details
      operationId: Get-Price-validation-detail
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - booking_tracking_id
                - member_id
              properties:

                booking_tracking_id:
                    type: string
                    description: Unique booking tracking ID
                    example: "111771747633261941E6VT"

                member_id:
                    type: string
                    description: Member account ID
                    example: "1"
              additionalProperties: true
            examples:
              default:
                value:
                  booking_tracking_id: "111771747633261941E6VT"
                  member_id: "1"
      responses:
        '200':
            description: Validation details for selected hotel room
            content:
              application/json:
                schema:
                  type: object
                  additionalProperties: true
                examples:
                  successful_validation_detail:
                    summary: Successful Get-price Validation Detail Response.
                    value:

                         "status": "success"
                         "booking_tracking_id": "111771747633261941E6VT"
                         "tracking_id": "11177174741026194FHMV2"
                         "room_tracking_id": "11177174741026194FHMV2-H1TL00142-0"
                         "price_change": "no-change"
                         "search_price": 
                              "currency": "BDT"
                              "amount": 10014.46
                         "validation_price": 
                            "currency": "BDT"
                            "amount": 10014.46
                        
                         "session_expire": 
                            "timestamp": 1771748533,
                            "datetime": "2026-02-22 14:22:13 +06"
                            "message": "The booking process should be completed by no later than 2026-02-22 14:22:13 +06."
                        
                         "search_parameter": 
                            "hotel_id": "H1TL00142#KGB1097616"
                            "checkIn": "2026-03-15"
                            "checkOut": "2026-03-16"
                            "total_night": "1"
                            "total_room": 2,
                            "total_adult": 4,
                            "total_child": 0,
                            "occupancies": [
                                {
                                    "room": 1,
                                    "adult": "2",
                                    "child": ""
                                },
                                {
                                    "room": 2,
                                    "adult": "2",
                                    "child": ""
                                }
                            ]
                            "guest_nationality": "BD"
                            "country_code": null
                            "supplement_key": null

                              
                          
                            "data": 
                                    "summery": 
                                        "tracking_id": "11177174741026194FHMV2"
                                        "room_tracking_id": "11177174741026194FHMV2-H1TL00142-0"
                                        "hotel_id": "H1TL00142#KGB1097616"
                                        "title": "DOUBLE CLUB QUEEN BED"
                                        "room_category": "club-room"
                                        "room_category_name": "Club Room"
                                        "room_category_priority": 15,
                                        "promo_price_tag": false,
                                        "total_amount": 10014.46,
                                        "sell_total_price": 10014.46,
                                        "currency": "BDT"
                                        "sales_commission": 0,
                                        "supplier": {
                                            "supplier_code": "travelrobothotel",
                                            "supplier_uid": "H1TL00142",
                                            "supplier_partner_code": "travelrobothotel-1-00142",
                                            "currency": "TRY",
                                            "purchase": 10014.46,
                                            "fmg_price": 10014.46
                                        }
                                        "hold_possible": "no"
                                        "policies": {
                                            "summery": "non-refundable",
                                            "auto_cancel": "2026-02-22T14:07:13",
                                            "auto_cancel_timestamp": "1771747633"
                                        }
                                    "data":
                                          "room_number": "DOUBLE CLUB QUEEN BED"
                                          "name": "DOUBLE CLUB QUEEN BED"
                                          "rate_comments": ".  Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00."
                                          "rate_code": "RO"
                                          "rate_type": "Room Only"
                                          "info": {
                                              "available_room": null,
                                              "size": []
                                          }
                                          "occupancies": {
                                              "total_room": "1",
                                              "adult": null,
                                              "child": null
                                          }
                                          "rate_data": {
                                              "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246"
                                          }
                                          "price": 
                                            "promo_tag": null,
                                            "purchase": {
                                                "total": {
                                                    "currency": "BDT",
                                                    "amount": 10014.46,
                                                    "before_discount": 10014.46,
                                                    "discount": 0,
                                                    "point": 0
                                                },
                                              "price_breakdown": {
                                                    "currency": "BDT",
                                                    "total": 10014.46,
                                                    "base_fare": 10014.46,
                                                    "tax": 0,
                                                    "extra_person_fee": 0,
                                                    "supplier_sales_comission": null,
                                                    "payable_at_property": []
                                                }
                                            }
                                            "sell": 
                                            "total": {
                                                    "currency": "BDT",
                                                    "amount": 10014.46,
                                                    "gross_price": 10014.46,
                                                    "platform_fees_or_extra_tax": 0,
                                                    "point": 0
                                            }
                                            "price_breakdown": {
                                                    "currency": "BDT",
                                                    "total": 10014.46,
                                                    "base_fare": 10014.46,
                                                    "tax": 0,
                                                    "platform_fees_or_extra_tax": 0,
                                                    "extra_person_fee": 0,
                                                    "supplier_sales_comission": null,
                                                    "payable_at_property": []
                                                }
                                            
                                            "fmg":
                                                "total": {
                                                    "currency": "TRY",
                                                    "amount": 10014.46
                                                }
                                          "price_breakdown": {
                                              "currency": "TRY",
                                              "total": 10014.46,
                                              "base_fare": 10014.46,
                                              "tax": 0,
                                              "extra_person_fee": 0,
                                              "supplier_sales_comission": null,
                                              "base_fare_fmg_charge": 0,
                                              "membership_discount_percentige": 0,
                                              "membership_discount_amount": 0,
                                              "final_base_fare_fmg_charge": 0,
                                              "payable_at_property": []
                                          }
                                          supplier": {
                                              "total": {
                                                  "currency": "TRY",
                                                  "amount": 10014.46
                                              },
                                              "price_breakdown": {
                                                  "currency": "TRY",
                                                  "total": 10014.46,
                                                  "base_fare": 10014.46,
                                                  "tax": 0,
                                                  "sales_tax": 0,
                                                  "property_fees": 0,
                                                  "surcharges": 0,
                                                  "service_charge": 0,
                                                  "extra_person_fee": 0,
                                                  "supplier_sales_comission": null,
                                                  "payable_at_property": []
                                              }
                                          }
                                          "meal_option": []
                                          "bed_option": []
                                          "amenities": []
                                          "cancellation_raw": [
                                              {
                                                  "CurrencyCode": "TRY",
                                                  "EndDate": "2026-03-15T00:00:00",
                                                  "Id": 0,
                                                  "PenaltyAmount": 10014.46,
                                                  "PenaltyBuyAmount": 10014.46,
                                                  "PolicyDescription": "Policy : penalty amount between 20.02.2026 19:59 - 15.03.2026 00:00 dates is 10,014.46 TRY",
                                                  "PolicyType": "Policy",
                                                  "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246",
                                                  "StartDate": "2026-02-20T19:59:00"
                                              }
                                          ]   
                                          "cancellation_policy": {
                                              "hold_possible": "no",
                                              "summery": "non-refundable",
                                              "auto_cancel": "2026-02-22T14:07:13",
                                              "auto_cancel_timestamp": "1771747633",
                                              "policy_breakdown": [],
                                              "post_booking_process": "auto",
                                              "book_now_pay_later": "no"
                                          }
                                    "room_number": "DOUBLE CLUB QUEEN BED"
                                    "name": "DOUBLE CLUB QUEEN BED"
                                    "rate_comments": ".  Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00."
                                    "rate_code": "RO"
                                    "rate_type": "Room Only"
                                    "info": {
                                        "available_room": null,
                                        "size": []
                                    }
                                    "occupancies": {
                                        "total_room": "1",
                                        "adult": null,
                                        "child": null
                                    }
                                    "rate_data": {
                                        "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@d6bfe6091b6a49a1b7942f51a39c6c8c"
                                    }
                            "price": 
                                "promo_tag": null,
                                "purchase": {
                                    "total": {
                                          "currency": "BDT",
                                          "amount": 10014.46,
                                          "before_discount": 10014.46,
                                          "discount": 0,
                                          "point": 0
                                      },
                                     "price_breakdown": {
                                          "currency": "BDT",
                                          "total": 10014.46,
                                          "base_fare": 10014.46,
                                          "tax": 0,
                                          "extra_person_fee": 0,
                                          "supplier_sales_comission": null,
                                          "payable_at_property": []
                                      }
                                  }
                                "sell": 
                                  "total": {
                                      "currency": "BDT",
                                      "amount": 10014.46,
                                      "gross_price": 10014.46,
                                      "platform_fees_or_extra_tax": 0,
                                      "point": 0
                                  }
                                  "price_breakdown": {
                                      "currency": "BDT",
                                      "total": 10014.46,
                                      "base_fare": 10014.46,
                                      "tax": 0,
                                      "platform_fees_or_extra_tax": 0,
                                      "extra_person_fee": 0,
                                      "supplier_sales_comission": null,
                                      "payable_at_property": []
                                  }
                            "fmg": {
                                  "total": {
                                      "currency": "TRY",
                                      "amount": 10014.46
                                  },
                                  "price_breakdown": {
                                      "currency": "TRY",
                                      "total": 10014.46,
                                      "base_fare": 10014.46,
                                      "tax": 0,
                                      "extra_person_fee": 0,
                                      "supplier_sales_comission": null,
                                      "base_fare_fmg_charge": 0,
                                      "membership_discount_percentige": 0,
                                      "membership_discount_amount": 0,
                                      "final_base_fare_fmg_charge": 0,
                                      "payable_at_property": []
                                  }
                              }
                            "post_booking_process": "auto"
                            "book_now_pay_later": "no"
                         "guest_data": []
                         "hotel_contents": 
                                "status": "success"
                                "hotel_id": "KGB1097616"
                                "supplier_code": "travelrobothotel"
                                "travelgate_supplier_code": "Test_020126"
                                "last_update": "Thursday, 1970-01-01 6:00 AM +06:00"
                                "data": 
                                    "created": "2026-02-22T09:08:21"
                                    "timestamp": 1771747701,
                                    "hotel_id": "KGB1097616"
                                    "name": "Club Quarters Hotel, Trafalgar Square"
                                    "name_local": "Club Quarters Hotel, Trafalgar Square"
                                    "hotel_formerly_name": "Club Quarters Hotel, Trafalgar Square"
                                    "destination_code": "540025"
                                    "country_code": "GB"
                                    "brand_text": null,
                                    "property_type": "Hotel"
                                    "star_rating": 4,
                                    "chain": null,
                                    "brand": null,
                                    "logo": null,
                                    "primary_photo": "https://cdn.kplus.com.tr/?url=aS50cmF2ZWxhcGkuY29tL2xvZGdpbmcvMjAwMDAwMC8xNTkwMDAwLzE1ODQ3MDAvMTU4NDY2MS8yYmIyMWY0NV9iLmpwZw=="
                                    "review_rating": {
                                        "source": null,
                                        "number_of_reviews": null,
                                        "rating_average": null,
                                        "popularity_score": null
                                    }
                                "policies": {
                                    "check_in": {
                                        "begin_time": null,
                                        "end_time": null,
                                        "instructions": null,
                                        "min_age": null
                                    },
                                    "checkout": {
                                        "time": null
                                    },
                                    "fees": {
                                        "optional": null
                                    },
                                    "know_before_you_go": null,
                                    "pets": [],
                                    "remark": null,
                                    "child_and_extra_bed_policy": {
                                        "infant_age": null,
                                        "children_age_from": null,
                                        "children_age_to": null,
                                        "children_stay_free": null,
                                        "min_guest_age": null
                                    },
                                    "nationality_restrictions": null
                                }
                                "address": 
                                      "latitude": 51.50712,
                                      "longitude": -0.125892,
                                      "address_line_1": "8 Northumberland Ave London, Greater London, England GB"
                                      "address_line_2": null,
                                      "city": null,
                                      "state": null,
                                      "country": null,
                                      "country_code": "GB"
                                      "postal_code": null,
                                      "full_address": "8 Northumberland Ave London, Greater London, England GB"
                                      "google_map_site_link": "http://maps.google.com/maps?q=8+Northumberland+Ave+London,+Greater+London,+England+GB"
                                      "local_lang": {
                                          "latitude": 51.50712,
                                          "longitude": -0.125892,
                                          "address_line_1": "8 Northumberland Ave London, Greater London, England GB",
                                          "address_line_2": null,
                                          "city": null,
                                          "state": null,
                                          "country": null,
                                          "country_code": "GB",
                                          "postal_code": null,
                                          "full_address": "8 Northumberland Ave London, Greater London, England GB",
                                          "google_map_site_link": "http://maps.google.com/maps?q=8+Northumberland+Ave+London,+Greater+London,+England+GB"
                                      }
                                      "mapping": {
                                            "continent_id": null,
                                            "country_id": null,
                                            "province_id": null,
                                            "state_id": null,
                                            "city_id": null,
                                            "area_id": null
                                        }
                                      "contacts": 
                                        "phone_numbers": [
                                            "44 207 8399333"
                                        ]
                                        "fax": []
                                        "email_address": [
                                            "memberservices@clubquarters.com"
                                        ]
                                        "website": []
                                      "room_type": []
                                      "spoken_languages": 
                                                {
                                                    "type": "spoken_languages",
                                                    "title": "English",
                                                    "icon": "mdi mdi-translate-variant"
                                                }
                                      "amenities": null,
                                      "facilities": 
                                          {
                                              "type": "Facility",
                                              "title": "Parking",
                                              "icon": "mdi mdi-translate-variant"
                                          }
                                      "hotel_photo": 
                                            {
                                                "picture_id": null,
                                                "title": "Primary image",
                                                "url": "https://cdn.kplus.com.tr/?url=aS50cmF2ZWxhcGkuY29tL2xvZGdpbmcvMjAwMDAwMC8xNTkwMDAwLzE1ODQ3MDAvMTU4NDY2MS8yYmIyMWY0NV9iLmpwZw=="
                                            }
                                      "point_of_interests": 
                                            {
                                                "code": "1",
                                                "name": "London Dungeon"
                                            }
                                      "nearest_airports": null,
                                      "train_stations": null,
                                      "connected_locations": null,
                                      "stadiums": null
                  hotel_id_missing_error:
                    summary: Hotel ID Missing in Validation Detail
                    value:
                      status: null
                      booking_tracking_id: null
                      tracking_id: null
                      room_tracking_id: null
                      price_change: null
                      search_price: null
                      validation_price: null
                      session_expire: null
                      search_parameter: null
                      data: null
                      guest_data: []
                      hotel_contents:
                        status: "failed"
                        hotel_id: null
                        supplier_code: null
                        travelgate_supplier_code: null
                        last_update: null
                        data:
                          status: "failed"
                          reason: "hotel_id data is required."
                                  
          
                                    
                                                                                                
                                                              
       
       
  /hotel/update-travellers:
    post:
      tags: 
      - Guest & Information Updates
      summary: Update travellers for a booking.
      operationId: hotelUpdateTravellersInfo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tracking_id
              - member_id
              - passenger
              properties:
                tracking_id:
                  type: string
                  description: Booking tracking ID from hotel booking step
                  example: "111771747633261941E6VT"
                member_id:
                  type: string
                  description: Logged-in member account ID
                  example: "1"

                save_pax:
                  type: string
                  description: Save passenger details for future bookings (yes / no)
                  example: "yes"
                passenger:
                  type: array
                  description: List of passengers for hotel booking
                  items:
                    type: object
                    required:
                      - pax_id
                      - room_number
                      - pax_type
                      - first_name
                      - last_name
                    properties:

                      pax_id:
                        type: string
                        description: Passenger ID
                        example: "1"

                      room_number:
                        type: string
                        description: Room number assigned for the passenger
                        example: "1"

                      pax_type:
                        type: string
                        description: Passenger type (ADT = Adult, CNN = Child)
                        example: "ADT"
                      gender:
                        type: string
                        description: Passenger gender (M / F)
                        example: "M"

                      title:
                        type: string
                        description: Passenger title (Mr / Mrs / Ms / Miss)
                        example: "Mr"

                      first_name:
                        type: string
                        description: Passenger first name
                        example: "Jhon"

                      last_name:
                        type: string
                        description: Passenger last name
                        example: "Doe"

                      age:
                        type: string
                        description: Passenger age
                        example: "30"

              additionalProperties: true
            examples:
              default:
                value:
                  {
                      "tracking_id": "111771747633261941E6VT",
                      "member_id": "1",
                      "save_pax": "yes",
                      "passenger": [
                          {
                              "pax_id": "1",
                              "room_number": "1",
                              "pax_type": "ADT",
                              "gender": "M",
                              "title": "Mr",
                              "first_name": "Jhon",
                              "last_name": "Doe",
                              "age": "30"
                          },
                          {
                              "pax_id": "2",
                              "room_number": "1",
                              "pax_type": "ADT",
                              "gender": "M",
                              "title": "Mr",
                              "first_name": "Jons",
                              "last_name": "Don",
                              "age": "30"
                          },
                                  {
                                      "pax_id": "3",
                                      "room_number": "2",
                                      "pax_type": "ADT",
                                      "gender": "M",
                                      "title": "Mr",
                                      "first_name": "Jins",
                                      "last_name": "Kon",
                                      "age": "30"
                                  },
                                  {
                                      "pax_id": "4",
                                      "room_number": "2",
                                      "pax_type": "ADT",
                                      "gender": "M",
                                      "title": "Mr",
                                      "first_name": "Smallll",
                                      "last_name": "Kids",
                                      "age": "30"
                                  }
                              ]
                          }
      responses:
        '200':
          description: Update hotel guest/traveller information
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_traveller_update:
                  summary: Successful Update travellers info Response.
                  value:
                         "status": "success"
                         "reason": "Passenger data has been successfully updated."
                         "tracking_id": "111771747633261941E6VT"
                         "total_guest": 2,
                         "data": [
                            {
                                "tracking_id": "111771747633261941E6VT",
                                "pax_id": "1",
                                "pax_type": "ADT",
                                "gender": null,
                                "title": "MR",
                                "first_name": "JHON",
                                "last_name": "DOE",
                                "pax_age": "30",
                                "isd_code": "",
                                "contact_no": "",
                                "email_address": "",
                                "supplement_data": "{\"selected_date\":null,\"arrival_date\":null,\"arrival_time\":null,\"arrival_flight_no\":null,\"to_city_name\":null,\"departure_date\":null,\"departure_time\":null,\"departure_flight_no\":null,\"from_city_name\":null}"
                            },  
                            {
                                "tracking_id": "111771747633261941E6VT",
                                "pax_id": "2",
                                "pax_type": "ADT",
                                "gender": null,
                                "title": "MR",
                                "first_name": "JONS",
                                "last_name": "DON",
                                "pax_age": "30",
                                "isd_code": "",
                                "contact_no": "",
                                "email_address": "",
                                "supplement_data": "{\"selected_date\":null,\"arrival_date\":null,\"arrival_time\":null,\"arrival_flight_no\":null,\"to_city_name\":null,\"departure_date\":null,\"departure_time\":null,\"departure_flight_no\":null,\"from_city_name\":null}"
                            },
                         ]
                invalid_guest_quantity:
                  summary: Invalid guest quantity error
                  value:
                    status: "failed"
                    reason: "The guest quantity provided is not valid. You have submitted data for 4 guest, but the required guest data is for 0 individuals."
                    tracking_id: "11176295152226194N5YLE"
                    submitted_total_guest: 4
                    required_total_guest: 0


       
  /hotel/create:
    post:
      tags: 
      - Booking Management
      summary: Create booking.
      operationId: hotelValidate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                  - tracking_id
                  - contact_no
                  - email_address
                  - payment_type
                  - member_id
              properties:

                  tracking_id:
                    type: string
                    description: Booking tracking ID from previous booking step
                    example: "111771747633261941E6VT"

                  room_tracking_id:
                    type: string
                    description: Selected room tracking ID (if applicable)
                    example: ""

                  isd_code:
                    type: string
                    description: ISD code for customer contact number
                    example: "1"

                  contact_no:
                    type: string
                    description: Customer contact number
                    example: "01700000000"

                  email_address:
                    type: string
                    format: email
                    description: Customer email address
                    example: "sandbox@example.com"

                  payment_type:
                    type: string
                    description: Payment method (e.g., account_balance, card, online_payment)
                    example: "account_balance"

                  redirect_url:
                    type: string
                    format: uri
                    description: URL to redirect after booking confirmation
                    example: "https://agent.example.com/booking-details/hotel"

                  agency_isd_code:
                    type: string
                    description: Agency ISD code
                    example: "1"

                  agency_contact_no:
                    type: string
                    description: Agency contact number
                    example: "01700000000"

                  agency_email:
                    type: string
                    format: email
                    description: Agency email address
                    example: "sandbox@example.com"

                  member_id:
                    type: string
                    description: Logged-in member account ID
                    example: "1"

                  special_requests_notes:
                    type: string
                    description: Additional special requests or notes for the booking
                    example: "n/a"
              additionalProperties: true
            examples:
              default:
                value:
                  tracking_id: 11175108883326193
                  room_tracking_id: 11175108883326193VKD98-H1AS00029-0
                  "isd_code": "1"
                  "contact_no": "01700000000"
                  "email_address": "sandbox@example.com"
                  "payment_type": "account_balance"
                  "redirect_url": "https://agent.example.com/booking-details/hotel"
                  "agency_isd_code": "1"
                  "agency_contact_no": "01700000000"
                  "agency_email": "sandbox@example.com"
                  "member_id": "1"
                  "special_requests_notes": "n/a"
      responses:
        '200':
          description: Response for final hotel booking creation and PNR generation.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_booking:
                  summary: Successful Create Booking Response.
                  value:
                        "status": "success"
                        "reason": "The booking has been successfully created, and it is associated with the Booking Id HO2622FEIDACKY."
                        "tracking_id": "111771747633261941E6VT"
                        "booking_id": "HO2622FEIDACKY"
                        "general": 
                            "service_type": "HOTEL"
                            "service_details": "Hotel 1 night(s) Booking Check-In 2026-03-15 and CheckOut 2026-03-16. 2 room(s) with 4 adult(s) 0 child(s)"
                            "booking_remarks": null,
                            "generated_date": "2026-02-22"
                            "partner_id": "1"
                            "master_partner_id": "1"
                            "branch_id": "BDHE001"
                            "tracking_id": "111771747633261941E6VT"
                            "booking_id": "HO2622FEIDACKY"
                            "hotel_ref_id": null,
                            "supplier_confirmation_id": "6VEW02X8Q5"
                            "supplier_others_id_a": "a7a2fb6a-33b9-4b9b-9d92-cfef08ee34cf"
                            "supplier_others_id_b": null,
                            "member_id": "1"
                            "book_by": "NS Nayeem"
                            "ip_address": null,
                            "timestamp": "1771748594"
                            "last_update": "1771748594"
                            "supplier_invoice_company": null,
                            "supplier_invoice_number": null
                        "voucher": {
                            "link": "https://manage.example.com/voucher/hotel-voucher?uid=eyJ0cmFja2luZ19pZCI6IjExMTc3MTc0NzYzMzI2MTk0MUU2VlQiLCJmdG1fcGFydG5lcl9pZCI6IjEiLCJtYXN0ZXJfcGFydG5lcl9pZCI6IjEiLCJtZW1iZXJfaWQiOiIxIiwibGlua19leHBpcmUiOiIyMDI2LTA1LTIzIn0=",
                            "pdf": "https://manage.example.com/voucher/hotel-booking-pdf?uid=eyJ0cmFja2luZ19pZCI6IjExMTc3MTc0NzYzMzI2MTk0MUU2VlQiLCJmdG1fcGFydG5lcl9pZCI6IjEiLCJtYXN0ZXJfcGFydG5lcl9pZCI6IjEiLCJtZW1iZXJfaWQiOiIxIiwibGlua19leHBpcmUiOiIyMDI2LTA1LTIzIn0="
                                     }
                        "booking": {
                            "status": "success",
                            "booking_status": "confirm",
                            "booking_supplier_status": "confirm",
                            "voucher_status": "issued",
                            "payment_status": "pending",
                            "auto_cancel_status": "pending",
                            "partner_timezone": "Asia/Dhaka",
                            "auto_cancel": "2026-02-22T14:07:13",
                            "auto_cancel_timestamp": "1771747633"
                        }
                        "price": {
                            "currency": "BDT",
                            "total_amount": "20028.92",
                            "sell_total_price": "20028.92",
                            "sales_comission": "0"
                        }
                        "hotel": 
                            "search_parameter": {
                                "hotel_id": "H1TL00142#KGB1097616",
                                "checkIn": "2026-03-15",
                                "checkOut": "2026-03-16",
                                "total_night": "1",
                                "total_room": 2,
                                "total_adult": 4,
                                "total_child": 0,
                                "occupancies": [
                                    {
                                        "room": 1,
                                        "adult": "2",
                                        "child": ""
                                    },
                                    {
                                        "room": 2,
                                        "adult": "2",
                                        "child": ""
                                    }
                                ],
                                "guest_nationality": "BD",
                                "country_code": null,
                                "supplement_key": null
                            }
                        "room": 
                              "summery": {
                                  "tracking_id": "11177174741026194FHMV2",
                                  "room_tracking_id": "11177174741026194FHMV2-H1TL00142-0",
                                  "hotel_id": "H1TL00142#KGB1097616",
                                  "title": "DOUBLE CLUB QUEEN BED",
                                  "room_category": "club-room",
                                  "room_category_name": "Club Room",
                                  "room_category_priority": 15,
                                  "promo_price_tag": false,
                                  "total_amount": 10014.46,
                                  "sell_total_price": 10014.46,
                                  "currency": "BDT",
                                  "sales_commission": 0,
                                  "supplier": {
                                      "supplier_code": "travelrobothotel",
                                      "supplier_uid": "H1TL00142",
                                      "supplier_partner_code": "travelrobothotel-1-00142",
                                      "currency": "TRY",
                                      "purchase": 10014.46,
                                      "fmg_price": 10014.46
                                  },
                                  "hold_possible": "no",
                                  "policies": {
                                      "summery": "non-refundable",
                                      "auto_cancel": "2026-02-22T14:07:13",
                                      "auto_cancel_timestamp": "1771747633"
                                  }
                              }
                        -"data"(): 
                
                              "room_number": "DOUBLE CLUB QUEEN BED"
                              "name": "DOUBLE CLUB QUEEN BED"
                              "rate_comments": ".  Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00."
                              "rate_code": "RO"
                              "rate_type": "Room Only"
                              "info": {
                                    "available_room": null,
                                      "size": []
                                  }
                        "occupancies": {
                                      "total_room": "1",
                                      "adult": null,
                                      "child": null
                                  }
                        "rate_data": {
                                      "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246"
                                  }
                        -"price": 
                                      "promo_tag": null,
                                      "purchase": {
                                          "total": {
                                              "currency": "BDT",
                                              "amount": 10014.46,
                                              "before_discount": 10014.46,
                                              "discount": 0,
                                              "point": 0
                                          },
                                          "price_breakdown": {
                                              "currency": "BDT",
                                              "total": 10014.46,
                                              "base_fare": 10014.46,
                                              "tax": 0,
                                              "extra_person_fee": 0,
                                              "supplier_sales_comission": null,
                                              "payable_at_property": []
                                          }
                                      }
                                      "sell": 
                                          "total": {
                                              "currency": "BDT",
                                              "amount": 10014.46,
                                              "gross_price": 10014.46,
                                              "platform_fees_or_extra_tax": 0,
                                              "point": 0
                                          }
                                      "price_breakdown": {
                                            "currency": "BDT",
                                            "total": 10014.46,
                                            "base_fare": 10014.46,
                                            "tax": 0,
                                            "platform_fees_or_extra_tax": 0,
                                            "extra_person_fee": 0,
                                            "supplier_sales_comission": null,
                                            "payable_at_property": []
                                        }
                                      "fmg": 
                                        "total": {
                                            "currency": "TRY",
                                            "amount": 10014.46
                                        }
                                        "price_breakdown": {
                                            "currency": "TRY",
                                            "total": 10014.46,
                                            "base_fare": 10014.46,
                                            "tax": 0,
                                            "extra_person_fee": 0,
                                            "supplier_sales_comission": null,
                                            "base_fare_fmg_charge": 0,
                                            "membership_discount_percentige": 0,
                                            "membership_discount_amount": 0,
                                            "final_base_fare_fmg_charge": 0,
                                            "payable_at_property": []
                                        }
                                      "supplier": 
                                          "total": {  
                                              "currency": "TRY",
                                              "amount": 10014.46
                                          }
                                          "price_breakdown": {
                                              "currency": "TRY",
                                              "total": 10014.46,
                                              "base_fare": 10014.46,
                                              "tax": 0,
                                              "sales_tax": 0,
                                              "property_fees": 0,
                                              "surcharges": 0,
                                              "service_charge": 0,
                                              "extra_person_fee": 0,
                                              "supplier_sales_comission": null,
                                              "payable_at_property": []
                                          }
                                      "meal_option": []
                                      "bed_option": []
                                      "amenities": []
                                      "cancellation_raw": [
                                          {
                                              "CurrencyCode": "TRY",
                                              "EndDate": "2026-03-15T00:00:00",
                                              "Id": 0,
                                              "PenaltyAmount": 10014.46,
                                              "PenaltyBuyAmount": 10014.46,
                                              "PolicyDescription": "Policy : penalty amount between 20.02.2026 19:59 - 15.03.2026 00:00 dates is 10,014.46 TRY",
                                              "PolicyType": "Policy",
                                              "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@e020e4194bc049eaa6c71104e812d246",
                                              "StartDate": "2026-02-20T19:59:00"
                                          }
                                      ]
                                      "cancellation_policy": 
                                        "hold_possible": "no"
                                        "summery": "non-refundable"
                                        "auto_cancel": "2026-02-22T14:07:13"
                                        "auto_cancel_timestamp": "1771747633"
                                        "policy_breakdown": []
                                    
                                      "room_number": "DOUBLE CLUB QUEEN BED"
                                      "name": "DOUBLE CLUB QUEEN BED"
                                      "rate_comments": ".  Check-in hour 15:00-.Car park YES (Without additional debit notes).Check-out hour -00:00."
                                      "rate_code": "RO"
                                      "rate_type": "Room Only"
                                      "info": {
                                          "available_room": null,
                                          "size": []
                                      }
                                      "occupancies": {
                                          "total_room": "1",
                                          "adult": null,
                                          "child": null
                                      }
                                      "rate_data": {
                                          "RoomCode": "fff05113fce24739a9cb3549eb78c043|@KGB1097616@29@d6bfe6091b6a49a1b7942f51a39c6c8c"
                                      }
                                      "price": 
                                        "promo_tag": null,
                                        "purchase": {
                                            "total": {
                                                "currency": "BDT",
                                                "amount": 10014.46,
                                                "before_discount": 10014.46,
                                                "discount": 0,
                                                "point": 0
                                            },
                                            "price_breakdown": {
                                                "currency": "BDT",
                                                "total": 10014.46,
                                                "base_fare": 10014.46,
                                                "tax": 0,
                                                "extra_person_fee": 0,
                                                "supplier_sales_comission": null,
                                                "payable_at_property": []
                                            }
                                        }
                                        "sell": 
                                          "total": {
                                              "currency": "BDT",
                                              "amount": 10014.46,
                                              "gross_price": 10014.46,
                                              "platform_fees_or_extra_tax": 0,
                                              "point": 0
                                          }
                                          "price_breakdown": {
                                              "currency": "BDT",
                                              "total": 10014.46,
                                              "base_fare": 10014.46,
                                              "tax": 0,
                                              "platform_fees_or_extra_tax": 0,
                                              "extra_person_fee": 0,
                                              "supplier_sales_comission": null,
                                              "payable_at_property": []
                                          }
                                          "fmg": 
                                            "total": {
                                                "currency": "TRY",
                                                "amount": 10014.46
                                            }
                                            "price_breakdown": {
                                                "currency": "TRY",
                                                "total": 10014.46,
                                                "base_fare": 10014.46,
                                                "tax": 0,
                                                "extra_person_fee": 0,
                                                "supplier_sales_comission": null,
                                                "base_fare_fmg_charge": 0,
                                                "membership_discount_percentige": 0,
                                                "membership_discount_amount": 0,
                                                "final_base_fare_fmg_charge": 0,
                                                "payable_at_property": []
                                            }
                                            "hotel_contents": 
                                              "created": "2026-02-22T09:23:12"
                                              "timestamp": 1771748592,
                                              "hotel_id": "KGB1097616"
                                              "name": "Club Quarters Hotel, Trafalgar Square"
                                              "name_local": "Club Quarters Hotel, Trafalgar Square"
                                              "hotel_formerly_name": "Club Quarters Hotel, Trafalgar Square"
                                              "destination_code": "540025"
                                              "country_code": "GB"
                                              "brand_text": null,
                                              "property_type": "Hotel"
                                              "star_rating": 4,
                                              "chain": null,
                                              "brand": null,
                                              "logo": null,
                                              "primary_photo": "https://cdn.kplus.com.tr/?url=aS50cmF2ZWxhcGkuY29tL2xvZGdpbmcvMjAwMDAwMC8xNTkwMDAwLzE1ODQ3MDAvMTU4NDY2MS8yYmIyMWY0NV9iLmpwZw=="
                                              "review_rating": {
                                                  "source": null,
                                                  "number_of_reviews": null,
                                                  "rating_average": null,
                                                  "popularity_score": null
                                              }
                                            "policies": 
                                              "check_in": {
                                                  "begin_time": null,
                                                  "end_time": null,
                                                  "instructions": null,
                                                  "min_age": null
                                              }
                                              "checkout": {
                                                  "time": null
                                              }
                                              "fees": {
                                                  "optional": null
                                              }
                                              "know_before_you_go": null,
                                              "pets": []
                                              "remark": null,
                                              "child_and_extra_bed_policy": {
                                                  "infant_age": null,
                                                  "children_age_from": null,
                                                  "children_age_to": null,
                                                  "children_stay_free": null,
                                                  "min_guest_age": null
                                              }
                                              "nationality_restrictions": null
                                          "address": 
                                              "latitude": 51.50712,
                                              "longitude": -0.125892,
                                              "address_line_1": "8 Northumberland Ave London, Greater London, England GB"
                                              "address_line_2": null,
                                              "city": null,
                                              "state": null,
                                              "country": null,
                                              "country_code": "GB"
                                              "postal_code": null,
                                              "full_address": "8 Northumberland Ave London, Greater London, England GB"
                                              "google_map_site_link": "http://maps.google.com/maps?q=8+Northumberland+Ave+London,+Greater+London,+England+GB"
                                              "local_lang": {
                                                  "latitude": 51.50712,
                                                  "longitude": -0.125892,
                                                  "address_line_1": "8 Northumberland Ave London, Greater London, England GB",
                                                  "address_line_2": null,
                                                  "city": null,
                                                  "state": null,
                                                  "country": null,
                                                  "country_code": "GB",
                                                  "postal_code": null,
                                                  "full_address": "8 Northumberland Ave London, Greater London, England GB",
                                                  "google_map_site_link": "http://maps.google.com/maps?q=8+Northumberland+Ave+London,+Greater+London,+England+GB"
                                              }
                                          "mapping": {
                                                "continent_id": null,
                                                "country_id": null,
                                                "province_id": null,
                                                "state_id": null,
                                                "city_id": null,
                                                "area_id": null
                                            }
                                        "contacts": {
                                              "phone_numbers": [
                                                  "44 207 8399333"
                                              ],
                                              "fax": [],
                                              "email_address": [
                                                  "memberservices@clubquarters.com"
                                              ],
                                              "website": []
                                          }
                                        
                                        "room_type": null,
                                        "spoken_languages": [
                                            {
                                                "type": "spoken_languages",
                                                "title": "English",
                                                "icon": "mdi mdi-translate-variant"
                                            }
                                        ]
                                        "amenities": null,
                                        "facilities": [
                                            {
                                                "type": "Facility",
                                                "title": "Parking",
                                                "icon": "mdi mdi-translate-variant"
                                            },
                                            {
                                                "picture_id": null,
                                                "title": "Primary image",
                                                "url": "https://cdn.kplus.com.tr/?url=aS50cmF2ZWxhcGkuY29tL2xvZGdpbmcvMjAwMDAwMC8xNTkwMDAwLzE1ODQ3MDAvMTU4NDY2MS8yYmIyMWY0NV9iLmpwZw=="
                                            },
                                            {
                                                "picture_id": null,
                                                "title": "Lobby",
                                                "url": "https://cdn.kplus.com.tr/?url=aS50cmF2ZWxhcGkuY29tL2xvZGdpbmcvMjAwMDAwMC8xNTkwMDAwLzE1ODQ3MDAvMTU4NDY2MS82ODMyYzZkM19iLmpwZw=="
                                            },
                                        ]
                                      "point_of_interests": [
                                          {
                                              "code": "1",
                                              "name": "London Dungeon"
                                          },
                                          {
                                              "code": "1",
                                              "name": "Westminster Bridge"
                                          },
                                      ]
                                      "nearest_airports": null,
                                      "train_stations": null,
                                      "connected_locations": null,
                                      "stadiums": null
                        "pax": 
                            "primary": 
                                "guest_name": "MR JHON DOE"
                                "guest_email": "sandbox@example.com"
                                "guest_isd_code": null,
                                "guest_contact_no": "101700000000"
                                "guest_nationality": "BD"
                        "data": [
                              {
                                  "Id": "6820",
                                  "timestamp": "1771748165",
                                  "last_update": "1771748211",
                                  "entry": "1",
                                  "entry_n": "NS Nayeem",
                                  "ftm_partner_id": "1",
                                  "master_partner_id": null,
                                  "tracking_id": "111771747633261941E6VT",
                                  "service_type": "HOTEL",
                                  "room_number": "1",
                                  "pax_id": "1",
                                  "passenger_id": null,
                                  "supplier_pax_id": null,
                                  "pax_type": "ADT",
                                  "paxType_Identity": null,
                                  "primary_ptc": null,
                                  "ptc_title": null,
                                  "gender": null,
                                  "title": "MR",
                                  "first_name": "JHON",
                                  "last_name": "DOE",
                                  "dob": null,
                                  "pax_age": "30",
                                  "nationality": null,
                                  "doc_type": null,
                                  "doc_country": null,
                                  "doc_no": null,
                                  "cnic": null,
                                  "doc_dateofexpiry": "2033-12-31",
                                  "doc_dateofissue": "2022-12-31",
                                  "frequent_flyer_airlines": null,
                                  "frequent_flyer": null,
                                  "purpose_of_visit": null,
                                  "special_request": null,
                                  "residential_address": null,
                                  "wheelchair_required": null,
                                  "isd_code": "",
                                  "contact_no": "",
                                  "email_address": "",
                                  "doc_pics": null,
                                  "seat_number": null,
                                  "baggage_option": null,
                                  "meal_option": null,
                                  "booking_id": null,
                                  "ticket_number": null,
                                  "ticket_status": null,
                                  "ticket_issueTimeStamp": null,
                                  "ticket_supplier_status": null,
                                  "ticket_status_title": null,
                                  "tktNumberValidation": "0",
                                  "comission_type": null,
                                  "comission_value": "0.00",
                                  "currency": null,
                                  "sell_total": "0.00",
                                  "sell_base_fare": "0.00",
                                  "sell_tax": "0.00",
                                  "sell_discount": "0.00",
                                  "sell_ait": "0",
                                  "sell_service_charge": "0.00",
                                  "sell_gross_base_fare": "0.00",
                                  "sell_gross_tax": "0.00",
                                  "cus_ticket_issue_charge": "0",
                                  "price_total": "0.00",
                                  "price_base_fare": "0.00",
                                  "price_tax": "0.00",
                                  "price_taxBreakdown_BD": "0.00",
                                  "price_taxBreakdown_UT": "0.00",
                                  "price_taxBreakdown_E5": "0.00",
                                  "price_taxBreakdown_YQ": "0.00",
                                  "price_taxBreakdown_YR": "0.00",
                                  "price_taxBreakdown_Other": "0.00",
                                  "price_discount": "0",
                                  "price_ait": "0",
                                  "price_service_charge": "0.00",
                                  "price_gross_base_fare": "0.00",
                                  "price_gross_tax": "0.00",
                                  "ticket_issue_charge": "0",
                                  "total_ticket_issue_charge": "0.00",
                                  "supplier_currency": null,
                                  "currencyExchangeRate": null,
                                  "fmg_total": "0.00",
                                  "fmg_base_fare": "0.00",
                                  "fmg_tax": "0.00",
                                  "fmg_discount": "0",
                                  "fmg_ait": "0",
                                  "fmg_service_charge": "0.00",
                                  "fmg_gross_base_fare": "0.00",
                                  "fmg_gross_tax": "0.00",
                                  "fmg_markup_type": null,
                                  "fmg_charge": "0",
                                  "fmg_revenue": "0.00",
                                  "supplier_total": "0.00",
                                  "supplier_base_fare": "0.00",
                                  "supplier_tax": "0.00",
                                  "supplier_discount": "0",
                                  "supplier_ait": "0",
                                  "supplier_service_charge": "0.00",
                                  "supplier_gross_base_fare": "0.00",
                                  "supplier_gross_tax": "0.00",
                                  "supplier_primary_commission": "0",
                                  "supplier_segment_feesCalculate": "0",
                                  "segment_discount_accountPurpose": null,
                                  "supplier_per_segment_discount": "0",
                                  "supplier_total_segment": "0",
                                  "supplier_total_segment_discount": "0",
                                  "gross_fare_total": null,
                                  "gross_fare_base_fare": "0.00",
                                  "gross_fare_tax": "0.00",
                                  "gross_fare_tax_BD": "0.00",
                                  "gross_fare_tax_UT": "0.00",
                                  "gross_fare_tax_E5": "0.00",
                                  "gross_fare_tax_YQ": "0.00",
                                  "gross_fare_tax_YR": "0.00",
                                  "gross_fare_tax_Other": "0.00",
                                  "gross_fare_tax_breakDownJSON": null,
                                  "gross_fare_discount_amount": "0.00",
                                  "gross_fare_ait_amount": "0.00",
                                  "gross_fare_service_charge": "0.00",
                                  "custom_gross_discount": "0.00",
                                  "custom_gross_charges": "0",
                                  "custom_gross_service_fee": "0",
                                  "custom_gross_markup": "0",
                                  "applicable_comission_title": null,
                                  "discount_comission_ratio": null,
                                  "discount_comission_type": null,
                                  "dynamic_markup_type": null,
                                  "dynamic_markup_title": null,
                                  "dynamic_markup_ratio": null,
                                  "passport_copy": null,
                                  "beneficiary_name": null,
                                  "beneficiary_relation": null,
                                  "beneficiary_cnic": null,
                                  "beneficiary_contact": null,
                                  "beneficiary_address": null,
                                  "spouse_adult_name": null,
                                  "spouse_adult_dob": null,
                                  "spouse_adult_passportno": null,
                                  "child1_name": null,
                                  "child1_dob": null,
                                  "child1_passportno": null,
                                  "child2_name": null,
                                  "child2_dob": null,
                                  "child2_passportno": null,
                                  "child3_name": null,
                                  "child3_dob": null,
                                  "child3_passportno": null,
                                  "child4_name": null,
                                  "child4_dob": null,
                                  "child4_passportno": null,
                                  "policyNumber": null,
                                  "policyVoucher": null,
                                  "isVoid": "0",
                                  "voidDate": null,
                                  "voidTimestamp": null,
                                  "isRefund": "0",
                                  "refundDate": null,
                                  "refundTimestamp": null,
                                  "refundSupplerAmount": null,
                                  "refundSupplerPenalty": null,
                                  "refundCharge": null,
                                  "refundAmount": null,
                                  "refundPenalty": null,
                                  "supplement_data": "{\"selected_date\":null,\"arrival_date\":null,\"arrival_time\":null,\"arrival_flight_no\":null,\"to_city_name\":null,\"departure_date\":null,\"departure_time\":null,\"departure_flight_no\":null,\"from_city_name\":null}"
                              },
                        ]
                        "partner": 
                          "agency_isd_code": "1"
                          "agency_contact_no": "01700000000"
                          "agency_email": "sandbox@example.com"
                          "contact": {
                              "person_name": "Nazmus",
                              "isd_code": "880",
                              "number": "1546776554",
                              "email": "cto@example.com.co"
                          }
                          "partner_id": "1"
                          "master_partner_id": "1"
                          "partner_type": "MASTER"
                          "partner_profile_code": "ITT"
                          "branch_id": "BDHE001"
                          "brand_name": "Demo Travel Tech"
                          "tag_line": "Next generation B2B travel reservation portal specially designed only for travel professionals"
                          "legal_name": "Demo Solution"
                          "city": "Singapore"
                          "state": "Singapore"
                          "postal_code": "049712"
                          "address": "30 Cecil Street # 19-08 Prudential Tower."
                          "country": "SG"
                          "website": "https://example.com/"
                          "customer_hotline": "2345678"
                          "support_email": "cto@example.com"
                          "customer_support_email": "no-reply@example.com"
                          "priavcy_link": "https://example.com/contact.php"
                          "terms_link": "https://example.com/contact.php"
                          "logo_1440_448": "https://cdn.demo.com/example/partner-brand-logo/1101760003818989887.png"
                          "logo_224_224": "https://cdn.demo.com/example/partner-brand-logo/1101760003818989887.png"
                          "logo_1024_1024": "https://cdn.demo.com/example/partner-brand-logo/1101760003818989887.png"
                          "logo_400_400": "https://cdn.demo.com/example/partner-brand-logo/1101760003818989887.png"
                          "logo_512_512": "https://cdn.demo.com/example/partner-brand-logo/1101760003818989887.png"
                          "logo_1706_256": "https://cdn.demo.com/example/partner-brand-logo/1101760003818989887.png"
                          "partner_from_email_address": "no-reply@reservationmastermind.com"
                          "partner_from_email_full_name": "Demo Travel Tech"
                        "supplier": 
                          "info": {
                              "supplier_type": "HOTEL",
                              "supplier_title": "travelrobot sendbox",
                              "supplier_code": "travelrobothotel",
                              "supplier_uid": "H1TL00142",
                              "supplier_partner_code": "travelrobothotel-1-00142",
                              "supplier_timezone": "Asia/Singapore",
                              "currency": "USD",
                              "notification_email": "operation@example.com",
                              "supplier_fare_rules": null,
                              "airlines_comission": null
                          }
                          "price": 
                            "supplier_currency": null,
                            "purchase": null,
                            "fmg_price": null,
                            "revenue": 0,
                            "currency_exchange_data": {
                                "agent_currency": "BDT",
                                "partner_currency_data": {
                                    "from_currency_list": [],
                                    "to_currency_list": [],
                                    "filter_data": null,
                                    "all_currency": []
                                }
                            }
                            "terms": {
                                  "status": "disable",
                                  "text": null
                              }
                          "terms": {
                              "status": "disable",
                              "text": null
                          }
                          "cancellation_terms": {
                              "status": "disable",
                              "text": null
                          } 
                price_validation_failed:
                  summary: Price Validation Failed
                  value:
                    status: "failed"
                    reason: "Price Validation is failed."

                invalid_guest_quantity:
                  summary: Invalid guest quantity error
                  value:
                    status: "failed"
                    reason: "The guest quantity provided is not valid. You have submitted data for 4 guest, but the required guest data is for 0 individuals."
                    tracking_id: "gdfgdfg"
                    submitted_total_guest: 4
                    required_total_guest: 0

                authorization_failed:
                  summary: Authorization Failed (Warning)
                  value:
                    status: "failed"
                    is_warning: "yes"
                    reason: "You do not have authorization to book through . Please reach out to the Support team for assistance."
                    reason_admin: " Book Hotel is Disable"
                        
                                                                                                   
                                          
                                    
                                    
        
        
  /hotel/booking-details:
    post:
      tags: 
      - Booking Management
      summary: Get details of a specific booking.
      operationId: hotelSearch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - tracking_id
                - booking_id
                - member_id
              properties:

                tracking_id:
                  type: string
                  description: Booking tracking ID generated during booking process
                  example: "111771747633261941E6VT"

                booking_id:
                  type: string
                  description: Final confirmed hotel booking ID
                  example: "HO2622FEIDACKY"

                member_id:
                  type: string
                  description: Logged-in user member ID
                  example: "1"
              additionalProperties: true
            examples:
              oneRoom:
                value:
                 {
                    "tracking_id": "111771747633261941E6VT",
                    "booking_id": "HO2622FEIDACKY",
                    "member_id": "1" 
                 }
      responses:
        '200':
          description: Detailed information about a specific hotel booking including voucher and hotel content.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_booking_details:
                  summary: Successful Booking Details Response
                  value:
                      {
                            "status": "string (success/failed)",
                            "reason": "string",
                            "tracking_id": "string",
                            "booking_id": "string",
                            "pay_tracking_id": "string or null",
                            "sendGTMEvent": "boolean",
                            "gateway_trx_id": "string or null",
                            "general": {
                                "service_type": "string",
                                "service_details": "string",
                                "booking_remarks": "string or null",
                                "generated_date": "string (YYYY-MM-DD)",
                                "partner_id": "string/int",
                                "master_partner_id": "string/int",
                                "branch_id": "string",
                                "tracking_id": "string",
                                "booking_id": "string",
                                "hotel_ref_id": "string or null",
                                "supplier_confirmation_id": "string",
                                "supplier_others_id_a": "string (UUID)",
                                "supplier_others_id_b": "null",
                                "member_id": "string",
                                "book_by": "string",
                                "timestamp": "string (Unix Timestamp)",
                                "last_update": "string (Unix Timestamp)",
                                "voucher": {
                                    "show_supplier_option": "string (yes/no)"
                                }
                            },
                            "voucher": {
                                "can_view_download": "string (yes/no)",
                                "link": "string (URL)",
                                "pdf": "string (URL)",
                                "pdf_with_price": "string (URL)",
                                "show_supplier_option": "string (yes/no)",
                                "qr_code": "string (show/hide)"
                            },
                            "booking": {
                                "status": "string",
                                "booking_status": "string (confirm/pending/cancel)",
                                "booking_supplier_status": "string",
                                "voucher_status": "string (issued/pending)",
                                "payment_status": "string",
                                "auto_cancel": "string (ISO Date)",
                                "auto_cancel_timestamp": "string (Unix Timestamp)"
                            },
                            "price": {
                                "currency": "string (e.g., BDT)",
                                "total_amount": "string/float",
                                "sell_total_price": "string/float",
                                "sales_comission": "string or null",
                                "applied_comission_ratio": "string/int"
                            },
                            "hotel": {
                                "search_parameter": {
                                    "hotel_id": "string",
                                    "checkIn": "string (YYYY-MM-DD)",
                                    "checkOut": "string (YYYY-MM-DD)",
                                    "total_night": "string/int",
                                    "total_room": "integer",
                                    "total_adult": "integer",
                                    "total_child": "integer",
                                    "occupancies": "array of objects",
                                    "guest_nationality": "string (ISO Country Code)"
                                },
                                "room": {
                                    "summery": {
                                        "title": "string",
                                        "room_category": "string",
                                        "total_amount": "float/double",
                                        "hold_possible": "string (yes/no)"
                                    },
                                    "data": "array of objects (Individual room details)",
                                    "post_booking_process": "string (auto/manual)"
                                },
                                "hotel_contents": {
                                    "hotel_id": "string",
                                    "name": "string",
                                    "star_rating": "integer",
                                    "primary_photo": "string (URL)",
                                    "address": {
                                        "latitude": "float",
                                        "longitude": "float",
                                        "full_address": "string"
                                    },
                                    "contacts": {
                                        "phone_numbers": "array of strings",
                                        "email_address": "array of strings"
                                    },
                                    "facilities": "array of objects (icons and titles)",
                                    "hotel_photo": "array of objects (URLs and titles)"
                                }
                            }
                        }
                no_booking_found:
                  summary: No booking data found error
                  value:
                    status: "failed"
                    reason: "no booking data found"
                    reason_admin: "no booking data available in the table"

                authorization_failed:
                  summary: Authorization Failed (Warning)
                  value:
                    status: "failed"
                    is_warning: "yes"
                    reason: "You do not have authorization to view this booking. Please reach out to the Support team for assistance."
                    reason_admin: "View Booking is Disable"
       
        
  /hotel/issue-voucher:
    post:
      tags: 
      - Booking Management
      summary: issue-voucher for booking.
      operationId: hotelIssueVoucher
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              
              required:
                - member_id
                - tracking_id
                - price_change_accepted
              properties:

                member_id:
                  type: string
                  description: Logged-in user member ID
                  example: "1"

                tracking_id:
                  type: string
                  description: Booking or Hotel tracking ID
                  example: "11177251811403210FPDT2"

                price_change_accepted:
                  type: string
                  description: Whether the price change is accepted ("yes" or "no")
                  enum: ["yes", "no"]
                  example: "no"

                notes:
                  type: string
                  description: Additional notes (optional)
                  nullable: true
                  example: "not required"
              additionalProperties: true
            examples:
              issue-voucher:
                value:
                  "member_id": "1"
                  "tracking_id": "11177251811403210FPDT2"
                  "price_change_accepted": "no"
                  "notes": "not required"
      responses:
        '200':
          description: Successfully issued voucher and generated PDF links.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
                successful_issue_voucher:
                  summary: Successful Issue Voucher Response
                  value:
                        "status": "success"
                        "reason": "The booking has been successfully Issue voucher"
                        "reason_admin": null,
                        "tracking_id": "11177251811403210FPDT2"
                        "booking_status": "confirm"
                        "pax_ticket_data": null,
                        "supplier_confirmation_id": null,
                        "past_booking_details": 
                            "last_update": "1772518220"
                            "tracking_id": "11177251811403210FPDT2"
                            "booking_id": "HO2603MA6SACYB"
                            "supplier_confirmation_id": "370036221"
                            "airlines_pnr": null,
                            "service_type": "HOTEL"
                            "status": "confirm"
                            "booking_status": "confirm"
                            "generated_date": "2026-03-03"
                        "Execute_Data": {
                            "status": "success",
                            "booking_status": "confirm",
                            "reason": "The booking has been successfully Issue voucher",
                            "booking_supplier_status": "ok"
                              }
                no_booking_data_found:
                  summary: No booking data found for issuance
                  value:
                    status: "failed"
                    reason: "no booking data found for tracking_id 11174066310326193J17FV "
                    reason_admin: "no booking data found for tracking_id 11174066310326193J17FV "
                    tracking_id: "11174066310326193J17FV"

                authorization_failed:
                  summary: Authorization Failed (Warning)
                  value:
                    status: "failed"
                    is_warning: "yes"
                    reason: "You do not have authorization to issue voucher. Please reach out to the Support team for assistance."
                    reason_admin: "Issue Voucher is Disable"
              
        
  /hotel/cancel-booking:
    post:
      tags: 
      - Booking Management
      summary: Cancel hotel booking.
      operationId: hotelCancelBooking
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - member_id
              - tracking_id
              properties:

                member_id:
                  type: string
                  description: Logged-in user member ID
                  example: "1"

                tracking_id:
                  type: string
                  description: Booking or Hotel tracking ID
                  example: "11177251811403210FPDT2"

                reason:
                  type: string
                  description: Reason for cancellation (optional)
                  nullable: true
                  example: "not required"
              additionalProperties: true
            examples:
              Cancel hotel booking:
                value:
                  "member_id": "1"
                  "tracking_id": "11177251811403210FPDT2"
                  "reason": "not required"
      responses:
        '200':
          description: Successfully cancelled booking
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              examples:
               default:
                summary: Successful Cancel Booking Response
                value:
                  "status": "success"
                  "reason": "The booking has been successfully canceled.. Refund ref id. ITT-RFD-030326-0052 request for BDT 490.36 has been successfully submitted. The finance team will proceed to verify and update accordingly."
                  "reason_admin": null,
                  "tracking_id": "11177251811403210FPDT2"
                  "booking_id": "HO2603MA6SACYB"
                  "booking_status": "cancel"
                  "booking_supplier_status": "cancel"
                  "cancellationReference": null,
                  "post_booking_details": {
                      "last_update": "1772518476",
                      "tracking_id": "11177251811403210FPDT2",
                      "booking_id": "HO2603MA6SACYB",
                      "supplier_confirmation_id": "370036221",
                      "airlines_pnr": null,
                      "service_type": "HOTEL",
                      "status": "cancel",
                      "booking_status": "cancel",
                      "generated_date": "2026-03-03"
                  } 
               no_booking_data_found:
                  summary: No booking data found for issuance
                  value:
                    status: "failed"
                    reason: "no booking data found for tracking_id 11174066310326193J17FV "
                    reason_admin: "no booking data found for tracking_id 11174066310326193J17FV "
                    tracking_id: "11174066310326193J17FV"

               authorization_failed:
                  summary: Authorization Failed (Warning)
                  value:
                    status: "failed"
                    is_warning: "yes"
                    reason: "You do not have authorization to issue voucher. Please reach out to the Support team for assistance."
                    reason_admin: "Issue Voucher is Disable"
        
        
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey
    secretCodeAuth:
      type: apiKey
      in: header
      name: secretecode
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    NotFound:
      description: Not found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    ServerError:
      description: Server error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string