❗ Error: MissingCityCodeElement = 109

Response Example : 

Main":{"Error":{"Code":109,"Message":"MissingCityCodeElement"},"DebugError":{"Incident":0,"TimeStamp":"2025-09-19 16:24:24","Message":"Missing 'CityCode' or 'Hotels/HotelId' Element under 'Root/Main'"

What it means : 

Your Search request is missing either a CityCode or a Hotels/HotelId element, depending on how you intend to search.
The system cannot process a hotel search without at least one of these identifiers.

Example of a wrong request : 
 

<Root>
    <Header debug="1">
        <Agency></Agency>
        <User></User>
        <Password></Password>
        <Operation>HOTEL_SEARCH_REQUEST</Operation>
        <OperationType>Request</OperationType>
    </Header>
    <Main Version="2.4" ResponseFormat="JSON">
        <SortOrder>1</SortOrder>
        <FilterPriceMin>0</FilterPriceMin>
        <Nationality>US</Nationality>
        <FilterPriceMax>10000</FilterPriceMax>
        <MaximumWaitTime>20</MaximumWaitTime>
        <MaxResponses>10000</MaxResponses>
        <FilterRoomBasises>
            <FilterRoomBasis></FilterRoomBasis>
        </FilterRoomBasises>
        <HotelName></HotelName>
        <Apartments>false</Apartments>
        
        <ArrivalDate>2025-11-19</ArrivalDate>
        <Nights>3</Nights>
        <Rooms>
            <Room Adults="2" RoomCount="1" ChildCount="0"></Room>
        </Rooms>
    </Main>
</Root>
 

Resolution / How to fix

Include either a valid CityCode or one or more HotelId elements under Root/Main in your search request.

✅ Example of a correct request (by hotel ID)

<Root>
    <Header debug="1">
        <Agency></Agency>
        <User></User>
        <Password></Password>
        <Operation>HOTEL_SEARCH_REQUEST</Operation>
        <OperationType>Request</OperationType>
    </Header>
    <Main Version="2.4" ResponseFormat="JSON">
        <SortOrder>1</SortOrder>
        <FilterPriceMin>0</FilterPriceMin>
        <Nationality>US</Nationality>
        <FilterPriceMax>10000</FilterPriceMax>
        <MaximumWaitTime>20</MaximumWaitTime>
        <MaxResponses>10000</MaxResponses>
        <FilterRoomBasises>
            <FilterRoomBasis></FilterRoomBasis>
        </FilterRoomBasises>
        <HotelName></HotelName>
        <Apartments>false</Apartments>
        <Hotels>
            <HotelId>96773</HotelId>
        </Hotels>
        <ArrivalDate>2025-11-19</ArrivalDate>
        <Nights>3</Nights>
        <Rooms>
            <Room Adults="2" RoomCount="1" ChildCount="0"></Room>
        </Rooms>
    </Main>
</Root>

Checklist before sending

• ✅ Add either <CityCode> or <Hotels><HotelId></HotelId></Hotels>.

• ✅ Confirm that the chosen ID (city code or hotel ID) exists in our static data.

• ✅ Ensure XML tags are spelled and nested correctly.