Room Management API

Contents

1. Overview

Room Management API is part of the Content API, however it's possible to use this part only for creating and managing Room Types. 

This API supports textual content only in English language. The content text in English language will be translated to multiple languages on our side. The contents for other languages other than English will be ignored. The endpoints between Hotels and Vacation Rental properties are shared. 

1.1. Version Information

Version : 6.4.8 

1.2. URL Scheme

Host : content-push-sandbox.agoda.com

BasePath : /

Schemes : HTTPS, HTTP 

2. Security

2.1. API Key

Type : apiKey

Name : Authorization

In : HEADER 

3. Managing Rooms

POST /cm/rooms

3.1. Description

Build new or modify rooms for properties which are authorized under your API credentials 

3.2. Body Parameters

List of rooms in OTA2017B format which need to be created

Name : body

Flags : required

Type : OTA_HotelInvNotifRQ

3.3. Responses

3.4. Consumes

application/xml 

3.5. Produces

application/xml 

3.6. Tags

Rooms 

3.7. Security

3.8. Example HTTP request

Request Path

/cm/rooms

Request Body

<?xml version="1.0" encoding="UTF-8"?>

<OTA_HotelInvNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/2017B/OTA_HotelInvNotifRQ.xsd">

  <SellableProducts HotelCode="9612080">

    <SellableProduct InvCode="101" InvNotifType="New">

      <GuestRoom>

        <Occupancy MaxOccupancy="2"/>

        <Room NumberOfBathroom="1" NumberOfBedroom="1" RoomID="Room898" SizeMeasurement="30"/>

        <Amenities>

          <Amenity AmenityCode="25" Value="1"/>

        </Amenities>

        <Description Language="en-US">

          <Text Language="en-US">Beach Front Rooms are 30 sqm with sea views. Saikaew Beach Resort provides all rooms, designed to offer you easy living by the sea among natural beauty, therefore, large windows in each room allow you to admire tropical garden or the beach right from your bed.</Text>

          <Image>https://images.sample.com/room/room-image-1.jpeg</Image>

        </Description>

        <TPA_Extensions>

          <SubRooms>

            <SubRoom RoomType="BedRoom">

              <Amenities>

                <Amenity AmenityCode="25" Value="1"/>

              </Amenities>

            </SubRoom>

          </SubRooms>

        </TPA_Extensions>

      </GuestRoom>

      <Description>

        <Text>Beachfront</Text>

      </Description>

    </SellableProduct>

  </SellableProducts>

</OTA_HotelInvNotifRQ>

3.9. Example HTTP response

Response 200

<?xml version="1.0" encoding="UTF-8"?>

<OTA_HotelInvNotifRS CorrelationID="8b417d6a-f3df-4d65-870c-240378b8ad3e">

  <Success/>

  <InventoryCrossRefs>

    <InventoryCrossRef RequestInvCode="Room898" ResponseInvCode="101"/>

  </InventoryCrossRefs>

</OTA_HotelInvNotifRS>

Response 400

<OTA_HotelInvNotifRS CorrelationID="325d8000-48cf-11ea-9337-8950898f7d75">

  <Errors>

    <Error Code="321" ShortText="Required field missing" Status="NotProcessed"/>

  </Errors>

</OTA_HotelInvNotifRS>

Response 401

<OTA_HotelInvNotifRS CorrelationID="325d8000-48cf-11ea-9337-8950898f7d75">

  <Errors>

    <Error Code="497" ShortText="Authorization error" Status="NotProcessed"/>

  </Errors>

</OTA_HotelInvNotifRS>