Rate Management API

The page will soon be discontinued. Please refer to this updated page instead - Click Here

Contents

1. Overview

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

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. apiKey

Type : apiKey

Name : Authorization

In : HEADER 

3. Managing Rates

3.1. Description

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

3.2. Body Parameter

List of RatePlans in OTA2017B format which need to be created 

Name : body

Flags : required

Type : OTA_HotelRatePlanNotifRQ 

3.3. Responses

3.4. Consumes

application/xml 

3.5. Produces

application/xml 

3.6. Tags

RatePlans 

3.7. Security

3.8. Example HTTP request

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

<OTA_HotelRatePlanNotifRQ 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_HotelRatePlanNotifRQ.xsd">

  <RatePlans HotelCode="9612080">

    <RatePlan RatePlanCode="123" RatePlanID="RatePlan12" RatePlanNotifType="New" RatePlanType="1">

      <Description Name="Standard Rate"/>

      <TPA_Extensions>

        <Channels>

          <Channel ChannelCode="1"/>

        </Channels>

      </TPA_Extensions>

    </RatePlan>

  </RatePlans>

</OTA_HotelRatePlanNotifRQ>

3.9. Example HTTP response

Response 200

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

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

  <Success/>

  <RatePlanCrossRefs>

    <RatePlanCrossRef RequestRatePlanCode="RatePlan12" ResponseRatePlanCode="123"/>

  </RatePlanCrossRefs>

</OTA_HotelRatePlanNotifRS>

Response 400

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

  <Errors>

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

  </Errors>

</OTA_HotelRatePlanNotifRS>

Response 401

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

  <Errors>

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

  </Errors>

</OTA_HotelRatePlanNotifRS>