Introduction

In late 2021, we introduced the Search API in JSON format to a select group of partners. Starting from Q1 2022, we made it available to all API partners. This new format offers faster API responses with less verbose input and greater flexibility in customizing your requests and responses using extra parameters.

Availability Search API

The Availability Search API provides rates and availability for all room types at specified hotels based on your search criteria and any additional parameters you may need (e.g., period of stay, number of passengers, currency).

Authorization / Header

Every request must include an Authorization Header containing your siteid and apikey separated by a colon. This header is mandatory for all API requests.

By adopting this new format, you can enjoy quicker responses and more tailored search results, enhancing your overall experience.

Authorization: 1234567: 00000000-0000-0000-0000-000000000000

Key: VALUE
Content-Type: application/json
Authorization: siteId:apikey

Search API - Request Example

{
    "waitTime": 60,
    "criteria": {
        "propertyIds": [
            12157
        ],
        "checkIn": "2022-12-23",
        "checkOut": "2022-12-24",
        "rooms": 1,
        "adults": 2,
        "children": 2,
        "childrenAges": [5,6],
        "language": "en-us",
        "currency": "USD",
        "userCountry": "US"
    },
    "features": {
        "ratesPerProperty": 25,
        "extra": [
            "content",
            "surchargeDetail",
            "CancellationDetail",
            "BenefitDetail",
            "dailyRate",
            "taxDetail",
            "rateDetail",
            "promotionDetail"
        ]
    }
}

Parameter for Search API - Request Schema (* = Require)

Element

Attribute

Description

waitTime
Integer

Partners can inform Agoda of the maximum wait time for a search response (in seconds). If partners are able to wait longer, Agoda will provide more availability options.

criteria*

propertyIds*
array[Integer]

Agoda Hotel IDs. Supports maximum 100 hotels per request. Please refer to “ratesPerProperty” for details.

checkIn*
Date

YYYY-MM-DD checkIn date must be hotel local timezone. It needs to be greater than, equal to or less than one day from today's date (to cover property time zone difference)

checkOut*
Date

YYYY-MM-DD checkOut date must be greater than checkIn date

rooms*
Integer

Number of Rooms

adults*
Integer

Number of Adults for the booking

children *
Integer

Number of children for the booking

childrenAges
array[Integer]

The age list of children(minimum: 0, maximum: 17).

To be passed only when no. of children > 0 and It is required to pass the same “childrenAges” throughout Search Request, Precheck Request & Book Request

If 2 children with ages of 5 and 6, then “childrenAges”:[5,6] Empty array like "childrenAges": [] is not allowed. Extra beds and meals are not guaranteed for stay for free children.

language*
String

Please refer to Appendix Language part for language codes

currency*
String

Please refer to Appendix Currency part for currency codes

userCountry
String

Guest's nationality should be provided using the ISO code. Implementing this is recommended to ensure you receive accurate rates. You can find more details in the Country section of the Appendix document. The code should be two characters long, containing only letters (a-z or A-Z).

Note: It is required to pass on the same userCountry throughout Search Request, Precheck Request & Book Request

features

ratesPerProperty
Integer

Number of best rate(s) available for a property. If ratesPerProperty is not provided, you will get the same result as sending 'ratesPerProperty' = 1 or 25 depending on the partnership type

Number of hotels	ratesPerProperty
For Single hotel search	1-100(max)
2-30 HIDs in one search	1-25(max)
31-100 HIDs in one search	1(max)

extra
array[String]

Optional parameters can be added to request additional details in the search response. For partners using the fulfillment model, please do not include "metaSearch" as it is not designed for this mode.

enum[
"content",
"dailyRate",
"metaSearch",
"benefitDetail",
"cancellationDetail",
"promotionDetail",
"rateDetail",
"surchargeDetail",
"taxDetail"
]

Parameter for Search API – Response Sample

{
    "searchId": 633141408144250000,
    "properties": [
        {
            "propertyId": 12157,
            "propertyName": "Medhufushi Island Resort",
            "translatedPropertyName": "Medhufushi Island Resort",
            "propertyUtcOffset": "+05:00",
            "rooms": [
                {
                    "roomId": 3134583,
                    "blockId": "MDZlNDc0NTUtMTU2My05MmY3LWQwNjUtYzM3MWY3YjkyZDBjOjMzMg==",
                    "roomName": "Beach Villa",
                    "parentRoomName": "Beach Villa",
                    "translatedRoomName": "Beach Villa",
                    "blockIdBackup": "06e47455-1563-92f7-d065-c371f7b92d0c",
                    "parentRoomId": 3134583,
                    "ratePlanId": 617128,
                    "freeWifi": false,
                    "remainingRooms": 38,
                    "normalBedding": 2,
                    "extraBeds": 0,
                    "freeBreakfast": true,
                    "freeCancellation": true,
                    "totalPayment": {
                        "exclusive": 83.96,
                        "inclusive": 107.14,
                        "tax": 15.46,
                        "fees": 7.72,
                        "taxDueSupplier": 0
                    },
                    "roomTypeNotGuaranteed": false,
                    "paymentModel": "Merchant",
                    "rate": {
                        "currency": "USD",
                        "exclusive": 74.56,
                        "inclusive": 95.14,
                        "tax": 13.8,
                        "fees": 6.78,
                        "method": "PRPN"
                    },
                    "perRoomPerNightRate": {
                        "currency": "USD",
                        "exclusive": 74.56,
                        "inclusive": 95.14,
                        "tax": 13.8,
                        "fees": 6.78
                    },
                    "dailyRate": [
                        {
                            "date": "2024-05-30",
                            "exclusive": 74.56,
                            "inclusive": 95.14,
                            "tax": 13.8,
                            "fees": 6.78,
                            "method": "PN"
                        }
                    ],
                    "promotionDetail": {
                        "promotionId": 196413638,
                        "codeEligible": false,
                        "description": "Limited Time Offer. Price includes 40% discount!",
                        "savingAmount": 108.2
                    },
                    "surcharges": [
                        {
                            "id": 255,
                            "method": "PB",
                            "charge": "Excluded",
                            "margin": "n",
                            "name": "Roundtrip Speed Boat Transfer Fee",
                            "rate": {
                                "currency": "USD",
                                "exclusive": 420,
                                "inclusive": 420,
                                "tax": 0,
                                "fees": 0
                            }
                        },
                        {
                            "id": 278,
                            "method": "PB",
                            "charge": "Mandatory",
                            "margin": "n",
                            "name": "Green Tax",
                            "rate": {
                                "currency": "USD",
                                "exclusive": 9.4,
                                "inclusive": 12,
                                "tax": 1.66,
                                "fees": 0.94
                            }
                        }
                    ],
                    "taxBreakdown": [
                        {
                            "id": "1",
                            "typeValue": "Tax",
                            "taxDescription": "Sales tax",
                            "translatedTaxDescription": "Sales tax",
                            "method": "PRPN",
                            "currency": "USD",
                            "base": "N",
                            "taxable": "N",
                            "percent": 16,
                            "amount": 13.8
                        },
                        {
                            "id": "2",
                            "typeValue": "Fee",
                            "taxDescription": "Service charge (taxable)",
                            "translatedTaxDescription": "Service charge (taxable)",
                            "method": "PRPN",
                            "currency": "USD",
                            "base": "N",
                            "taxable": "Y",
                            "percent": 10,
                            "amount": 6.78
                        }
                    ],
                    "cancellationPolicy": {
                        "code": "1D1N_1N",
                        "cancellationText": "Risk-free booking! Cancel before 2024-05-29 and you'll pay nothing! Any cancellation received within 1 day prior to the arrival date will incur the first night's charge. Failure to arrive at your hotel or property will be treated as a No-Show and will incur the first night's charge (Hotel policy).",
                        "translatedCancellationText": "Risk-free booking! Cancel before 2024-05-29 and you'll pay nothing! Any cancellation received within 1 day prior to the arrival date will incur the first night's charge. Failure to arrive at your hotel or property will be treated as a No-Show and will incur the first night's charge (Hotel policy).",
                        "parameter": [
                            {
                                "days": 2,
                                "charge": "N",
                                "value": 0
                            },
                            {
                                "days": 1,
                                "charge": "N",
                                "value": 1
                            },
                            {
                                "days": 0,
                                "charge": "N",
                                "value": 1
                            }
                        ],
                        "date": [
                            {
                                "before": "2024-05-29T00:00:00",
                                "rate": {
                                    "exclusive": 0,
                                    "inclusive": 0,
                                    "tax": 0,
                                    "fees": 0
                                }
                            },
                            {
                                "before": "2024-05-30T00:00:00",
                                "rate": {
                                    "exclusive": 74.56,
                                    "inclusive": 95.14,
                                    "tax": 13.8,
                                    "fees": 6.78
                                }
                            },
                            {
                                "onward": "2024-05-30T00:00:00",
                                "rate": {
                                    "exclusive": 74.56,
                                    "inclusive": 95.14,
                                    "tax": 13.8,
                                    "fees": 6.78
                                }
                            }
                        ]
                    },
                    "benefits": [
                        {
                            "id": 1,
                            "benefitName": "Breakfast",
                            "translatedBenefitName": "Breakfast"
                        },
                        {
                            "id": 10,
                            "benefitName": "Welcome drink",
                            "translatedBenefitName": "Welcome drink"
                        },
                        {
                            "id": 34,
                            "benefitName": "Express check-in",
                            "translatedBenefitName": "Express check-in"
                        },
                        {
                            "id": 95,
                            "benefitName": "Free WiFi",
                            "translatedBenefitName": "Free WiFi"
                        },
                        {
                            "id": 230,
                            "benefitName": "Drinking water",
                            "translatedBenefitName": "Drinking water"
                        },
                        {
                            "id": 115,
                            "benefitName": "Free fitness center access",
                            "translatedBenefitName": "Free fitness center access"
                        }
                    ]
                }
            ]
        }
    ]
}

Parameter for Search API - Response Schema (* = Require)

Element	Attribute	Description
searchId*		The unique ID that this search received in our system
properties	propertyId* integer	Agoda's hotel ID
	propertyName string	Hotel name, This field can only be returned when sending "content" in "extra"
	translatedPropertyName string	Translated hotel name, This field can only be returned when sending "content" in "extra"
	propertyUtcOffset string	Utc Timezone of the Property
properties->rooms	roomId* long	The ID of the room type
	blockId* string(max 500 bytes)	New unique identifier for each room, provide as a unique key for partner’s caching. Please use this one instead of blockIdBackup.Possible characters for blockID includes: • Uppercase letters: A-Z • Lowercase letters: a-z • Digits: 0-9 • Plus (+) • Slash (/) • Underscore (_) • Equals sign (=) • Dash (-)
	roomName string	Room Name, This field can only be returned when sending "content" in "extra"
	parentRoomName string	Parent room name, This field can only be returned when sending "content" in "extra"
	translatedRoomName string	Room name translated (As per language you perform in the request), This field can only be returned when sending "content" in "extra"
	blockIdBackup string	Old version of blockId, in XML format response.
	parentRoomId* long	The ID of the parent room type
	ratePlanId* long	Used to identify the Agoda rate plan
	freeWifi boolean	True if Free Wifi available, This field can only be returned when sending "content" in "extra"
	remainingRooms integer	The rooms (allotment) remaining under same Room ID. This field can only be returned when sending "rateDetail" in 'extra'
	normalBedding integer	Number of occupancies with normal bedding. This field can only be returned when sending 'rateDetail' in 'extra'
	extraBeds integer	Number of extra beds. This field can only be returned when sending 'rateDetail' in 'extra'
	freeBreakfast* boolean	True if breakfast included for this rate
	freeCancellation* boolean	True if there is Free cancellation for booking in this room
	freeCancellationDate DateTime	Free cancellation date in the format YYYY-MM- DD. This field can only be returned when sending "metaSearch" in "extra"
	landingUrl string	The landing page URL that you use if the customer clicks through. This field can only be returned when sending "metaSearch" in "extra"
	roomTypeNotGuaranteed boolean	True if it is Run of House room type. This field can only be returned when sending ‘rateDetail’ in 'extra'
	payAtHotel Boolean	True if there is the pay at hotel is available for this booking in this room.This field can only be returned when sending "metaSearch" in "extra"
	paymentModel string	Possible values for paymentModel field are: - Agency: Booking will be charged at hotel, - Merchant: Pre-paid, - MerchantCommission: Pre-paid This field can only be returned when sending "rateDetail" in "extra"
	bookNowPayLaterDate string	Later date on which the payment is to be made in BNPL
properties -> rooms ->totalPayment	exclusive Number	Exclusive rate breakdown per booking, excluding taxes but includes room charge and mandatory surcharges
	inclusive Number	Rate breakdown per booking, including room charge and mandatory surcharge
	tax Number	Tax breakdown per booking
	fees Number	Fees breakdown per booking
	estimatedCommission Number	Estimated commission that partner may get. For sell rate partners only. Please contact technical team to get this column.
	taxDueSupplier Number	Agoda owes supplier as tax
properties->rooms->rate*	currency string	Requested currency. Details are on Currency Part (Appendix)
	exclusive* number	The cost per defined "method" exclusive of tax and service fees
	inclusive* number	The cost per defined "method" inclusive of tax and service fees
	tax* number	Tax amount of room value
	fees* number	Fees of room value
	method string	Possible method values are as follows -PRPN: Per room per night -PB: Per booking -PN: Per night -PR: Per room
	stayPackageType integer	Used to identify special offer package. Not applicable for all partners. Please contact technical team for more detail.
properties->rooms->perRoomPerNightRate	currency string	Requested currency. Details are on Currency Part (Appendix)
	exclusive* number	The cost per room per night exclusive of tax and service fees
	inclusive* number	The cost per room per night inclusive of tax and service fees
	tax* number	Tax amount of room value
	fees* number	Fees of room value
	stayPackageType integer	Used to identify special offer package. Not applicable for all partners. Please contact technical team for more detail.
properties->rooms->rate->ratePlan (Not applicable for all partners and not all rates will have this info.)	name string	Name of the special rate plan
	description string	Description of the special rate plan, max character length is 2000.
	inclusions string	Inclusions that are applicable for the special rate plan, max character length is 2000.
	exclusions string	Exclusions that are applicable for the special rate plan, max character length is 2000.
	checkInTime string	Check-In time at hotel that are applicable for the special rate plan
	checkoutTime string	Check-out time at hotel that are applicable for the special rate plan
properties->rooms->rate->ratePlan->checkInTime(Not applicable for all partners and not all rates will have this info.)	startTime string	Start time of check-in for the special rate plan. Returned only if applicable.
	endTime string	End time of check-in for the special rate plan. Returned only if applicable.
properties->rooms->rate->ratePlan->checkoutTime(Not applicable for all partners and not all rates will have this info.)	startTime string	Start time of check-out for the special rate plan. Returned only if applicable.
	endTime string	Start time of check-out for the special rate plan. Returned only if applicable.
properties->rooms->dailyRate	date* DateTime	YYYY-MM-DD
	exclusive* number	Rate breakdown per night exclusive of tax and service fees
	tax* number	Tax breakdown per night
	fee* number	Fees breakdown per night
	inclusive number	Rate breakdown per night inclusive of tax and service fees
	method string	Always "PN", stands for Per Night
properties -> rooms -> promotionDetail	promotionId Integer	Promotion ID
	codeEligible Boolean	True if special promotion code could be applied to this room/rate
	description String	Promotion description
	savingAmount Number	Promotion saved amount
properties -> rooms -> surcharges	id Integer	Surcharge ID
	method String	Always "PB", stands for Per Booking
	charge String	Possible charge values as follows: - Mandatory – Surcharges will be charged in addition to room price at time of booking creation - Excluded – Surcharges are not charged at time of booking creation; customers will pay the surcharges at the hotel directly
	margin Number	There are two possible values for "margin" as follows: y=Margin applied n=No surcharge margin
	name String	Surcharge name
	rate-> currency String	Surcharge currency (As per search request)
	rate-> exclusive Number	Surcharge exclusive amount
	rate-> inclusive Number	Surcharge inclusive amount
	rate-> tax Number	Surcharge tax amount
	rate-> fees Number	Surcharge fees amount
properties->rooms[]->room->taxBreakdown	id* string	Tax ID
	typeValue* string	Possible types are: “Tax” and “Fee”
	taxDescription* string	Tax or Fee description
	translatedTaxDescription* string	Translated tax description (As per search request)
	method* string	Possible method values as follows: PAPB=Per Adult Per Booking PAPD=Per Adult Per Day PAPN=Per Adult Per Night PB=Per Booking PCPB=Per Child Per Booking PCPD=Per Child Per Day PCPN=Per Child Per Night PGPB=Per Guest Per Booking PGPD=Per Guest Per Day PGPN=Per Guest Per Night PN=Per Night PRPB=Per Room Per Booking PRPN=Per Room Per Night
	base* string	There are possible values for ‘base’ as follows: M=Tax over Margin N=Tax over Net
	taxable* string	Possible taxable values are Y=Tax apply over fee N=Tax doesn’t apply over fee
	percent* number	Tax or fee percentage
	currency* string	Currency of tax or fee as per search request
	amount* number	Tax or fee amount of its currency
properties ->rooms -> cancellationPolicy	code String	Cancellation policy in code format. E.g. 1D1N_100P
	cancellationText String	Cancellation policy in text format
	translatedCancellationText String	Cancellation policy in translated text format Note: Translated policy may be identical to the source cancellationText.
properties ->rooms -> cancellationPolicy -> parameter	days Integer	Number of days prior to check-in date that cancellation fee will be applied. Except for: 365 Days with 100 Percent=the booking is non-refundable.
	charge String	There are two possible values for "charge" as follows: N=Night P=Percent
	value Integer	Charge value
properties ->rooms cancellationPolicy -> date	before timestamp	Datetime in hotel local time, YYYY-MM-DDTHH:MM:SS
properties ->rooms cancellationPolicy -> date	onward timestamp	Datetime in hotel local time, YYYY-MM-DDTHH:MM:SS
properties -> cancellationPolicy -> date -> rate	exclusive Number	Exclusive amount of cancellation fee
	inclusive Number	Total amount of cancellation fee
	tax Number	Cancellation tax amount
	fees Number	Cancellation fees amount
properties->rooms->benefits	id* long	Benefit ID
	benefitName* string	Benefit name Please check how to identify benefit quantity in our best practice page.
	translatedBenefitName* string	Benefit name translated
properties->rooms->feeWaivers (For CA hotels only)	feeWaivers string	Total amount of fee waiver in percentage, 100P, 0P etc.
	expiry string	Expiry time in hours format, 24H, 48H etc.
	leadTime string	Total lead time in hours format, 24H, 48H etc.

Below are "extra" parameter(s) in search request and additional data could get from response.

{
   "features":{
      "extra":[
         "metaSearch"
      ]
   }
}

Element	Attribute	Description
properties -> rooms ->	landingUrl String	The landing page URL that you use if the customer clicks through
payAtHotel Boolean	True if there is the pay at hotel is available for this booking in this room
freeCancellationDate Date	Free cancellation date in the format YYYY-MM-DD. Free cancellation BEFORE 'freecancelationdate' (i.e. the day before until 23:59:59)

Element

Attribute

Description

properties -> rooms ->

landingUrl

String

The landing page URL that you use if the customer clicks through

payAtHotel

Boolean

True if there is the pay at hotel is available for this booking in this room

freeCancellationDate

Date

Free cancellation date in the format YYYY-MM-DD. Free cancellation BEFORE 'freecancelationdate' (i.e. the day before until 23:59:59)

{
  "features":{
    "extra":[
      "rateDetail"
    ]
  }
}

Element	Attribute	Description
properties -> rooms ->	remainingRooms Integer	The rooms (allotment) remaining under same Room ID.
	normalBedding Integer	Number of occupancies with normal bedding
	extraBeds Integer	Number of extra beds
	roomTypeNotGuaranteed Boolean	True if it is Run of House room type
	paymentModel String	Possible values for paymentModel field are: - agency: Booking will be charged at hotel, - merchant, - merchantcommission
properties -> rooms ->totalPayment	exclusive Number	Exclusive rate breakdown per booking, excluding taxes but includes room charge and mandatory surcharges
	inclusive Number	Rate breakdown per booking, including room charge and mandatory surcharge
	tax Number	Tax breakdown per booking
	fees Number	Fees breakdown per booking
	estimatedCommission Number	Estimated commission that partner may get. For sell rate partner only. Please contact technical team to get this column.
properties->rooms[]->room->perRoomPerNightRate	currency string	Requested currency. Details are on Currency Part (Appendix)
	exclusive* number	The cost per room per night exclusive of tax and service fees
	inclusive* number	The cost per room per night inclusive of tax and service fees
	tax* number	Tax amount of room value
	fees* number	Fees of room value

{
  "features":{
    "extra":[
      "benefitDetail"
    ]
  }
}

Element	Attribute	Description
properties -> rooms -> benefits	id Integer	Benefit ID
benefitName String	Benefit name
translatedBenefitName String	Benefit name translated

Element

Attribute

Description

properties -> rooms -> benefits

Integer

Benefit ID

benefitName

String

Benefit name

translatedBenefitName

String

Benefit name translated

{
  "features":{
    "extra":[
      "dailyRate"
    ]
  }
}

Element	Attribute	Description
dailyRate	date String	YYYY-MM-DD
	exclusive Number	Rate breakdown per night exclusive of tax and service fees
	inclusive Number	Rate breakdown per night inclusive of tax and service fees
	tax Number	Tax breakdown per night
	fees Number	Fees breakdown per night
	method string	Always "PN", stands for Per Night.

{
  "features":{
    "extra":[
      "cancellationDetail"
    ]
  }
}

Element	Attribute	Description
properties ->rooms -> cancellationPolicy	code String	Cancellation policy in code format. E.g. 1D1N_100P
	cancellationText String	Cancellation policy in text format
	translatedCancellationText String	Cancellation policy in translated text format Note: Translated policy may be identical to the source cancellationText.
properties ->rooms -> cancellationPolicy -> parameter	days Integer	Number of days prior to check-in date that cancellation fee will be applied. Except for: 365 Days with 100 Percent=the booking is non-refundable.
	charge String	There are two possible values for 'charge' as follows: N=Night P=Percent
	value Integer	Charge value
properties ->rooms -> cancellationPolicy -> date	before t imestamp	Datetime in hotel local time, YYYY-MM-DDTHH:MM:SS
properties ->rooms -> cancellationPolicy -> date	onward timestamp	Datetime in hotel local time, YYYY-MM-DDTHH:MM:SS
properties > rooms ->cancellationPolicy -> date -> rate	exclusive Number	Exclusive cancellation fee
	inclusive Number	Total amount of cancellation fee
	tax Number	Cancellation tax amount
	fees Number	Cancellation fees amount

{
  "features":{
    "extra":[
      "content"
    ]
  }
}

Element	Attribute	Description
properties ->	propertyName String	Hotel name
properties ->	translatedPropertyName String	Translated hotel name
properties -> rooms ->	roomName String	Room name
	parentRoomName String	Parent room name
	translatedRoomName String	Room name translated (as per language you perform in the request)
	freeWifi Boolean	True if Free Wifi available

{
  "features":{
    "extra":[
      "surchargeDetail"
    ]
  }
}

Element	Attribute	Description
properties -> rooms -> surcharges	id Integer	Surcharge ID
	method String	Always "PB", stands for Per Booking
	charge String	Possible charge values as follows: - Mandatory – Surcharges will be charged in addition to room price at time of booking creation - Excluded – Surcharges are not charged at time of booking creation; customers will pay the surcharges at the hotel directly
	margin Number	There are two possible values for "margin" as follows: y=Margin applied n=No surcharge margin
	name String	Surcharge name
	rate-> currency String	Surcharge currency (As per search request)
	rate-> exclusive Number	Surcharge exclusive amount
	rate-> inclusive Number	Surcharge inclusive amount
	rate-> tax Number	Surcharge tax amount
	rate-> fees Number	Surcharge fees amount

{
  "features":{
    "extra":[
      "taxDetail"
    ]
  }
}

Element	Attribute	Description
properties -> rooms -> taxBreakdown	id Integer	Tax ID
	typeValue String	Possible types are: "Tax" or "Fee"
	taxDescription String	Tax or Fee description
	translatedTaxDescription String	Translated tax description
	method String	Possible method values as follows: PAPB=Per Adult Per Booking PAPD=Per Adult Per Day PAPN=Per Adult Per Night PB=Per Booking PCPB=Per Child Per Booking PCPD=Per Child Per Day PCPN=Per Child Per Night PGPB=Per Guest Per Booking PGPD=Per Guest Per Day PGPN=Per Guest Per Night PN=Per Night PRPB=Per Room Per Booking PRPN=Per Room Per Night
	currency String	Tax or fee amount of its currency
	base String	There are possible values for ‘base’ as follows: M=Tax over Margin N=Tax over Net
	taxable String	Possible taxable values are Y=Tax apply over fee N=Tax doesn't apply over fee
	percent Number	Tax or fee percentage
	amount Number	Tax or fee amount of its currency
	taxProtoTypeId Integer	taxTypeId refers to the nature of the tax, whether it is paid to the state government etc. Mainly used by US properties.
	taxDueSupplier Number	Agoda owes supplier as tax

{
  "features":{
    "extra":[
      "promotionDetail"
    ]
  }
}

Element	Attribute	Description
properties -> rooms -> promotionDetail	promotionId Integer	Promotion ID
	codeEligible Boolean	True if special promotion code could be applied to this room/rate
	description String	Promotion description
	savingAmount Number	Promotion saved amount