API Reference

Overview

1. Overview

The API allows Agoda’s connectivity partners to create new properties and update existing properties.

  • It has support for both Hotel and Non-Hotel (Vacation rental) properties.

  • Presently it supports textual content in English language only. Text in other languages will be ignored. The content added in English will be translated into multiple languages.

  • Field types:

    • required: must always be sent, this is required to make the property sellable.

    • optional:

      • Unless otherwise specified, all fields are overwritten. When no value is sent, this disables the function and in some instances applies a default e.g. if a particular Service is not provided in the request, it is assumed that this service is not offered, and if MinLengthOfStay/MaxLengthOfStay is not provided, then a default of '-1' i.e. no limit will be set.

      • Where a field is indicated as (Overlay): If no value is sent, no update will be made and existing data will be retained e.g. NumberOfBathroom or MaxChildrenInRoom.

  • For Direct Connects:

    • If the contract configuration is on Supplier level then contract sign flow is not required. Please avoid following paths:

      • Get Contract

      • Sign Contract

      • Get Host Contracts

      • Sign Host Contract

    • FeePolicies will not be created or updated via Content API. It can only created or updated via ELMO tool.

  • For RatePlan:

    • Typically, in the Agoda system, the Name in Description of the RatePlan is combined with the RatePlanID given by our partners prior to saving. For example:

    • RatePlanID: "RP000001"

    • Description: "Special Rate"

    • Description save in Agoda System: "(RP000001) Special Rate"

    • Description while fetch by partner from Agoda System: "(RP000001) Special Rate"

    • Description while create/update: "Special Rate"

1.1. Version information

Version : 1.0.15

1.2. URI scheme

Host : content-push.agoda.com
BasePath : /
Schemes : HTTPS, HTTP

1.3. Tags

  • CodeLists

  • Contracts

  • ErrorCodes

  • Host Contracts

  • HotelProducts

  • Properties

  • PropertyInfo

  • PropertyOverallStatus

  • PropertyStatus

  • RatePlanStatus

  • RatePlans

  • RoomStatus

  • Rooms