Request URL: https://supply.agoda.com/api?apiKey=ADDYOURAPIKEYHERE
The customized Japan Child Rates feature will be deployed only on properties located within Japan. The Japan Child Rates has to be set manually on the YCS Extranet, and can be retrieved via the GetBookingDetails endpoint. The booking retrieval response for Japanese properties will be identical with the standard response, with the additional "occupancy" element, which provides a headcount for adults and children within each age bucket.
Example Request
<?xml version="1.0" encoding="UTF-8"?>
<request timestamp="1436931804">
<criteria language="JA">
<property id ="20389XXXX">
<booking id="6407XXXX"/>
</property>
</criteria>
</request>
<!--
Max property id is restricted to 1 (configurable)
Max booking ids restricted to 50 (configurable)
-->
For more information, please see the documentation for details on GetBookingDetailsRQ elements and attributes.
Example Response
<result timestamp="1653637167151">
<bookings count="1" iataid="96637800">
<booking property_id="203895644" property_name="J-ASO hotel" booking_id="64071569" booking_date="2022-05-27T14:37:00+07:00" last_action="2022-05-27T14:36:42+07:00" arrival="2022-06-13" departure="2022-06-14" status="ConfirmBooking" acknowledge="0" room_id="1207710824" room_type="スタジオ" channel_id="1" channel_name="Retail" rateplan_id="8155680" rateplan_name="Japan ASO no imageee" promotion_id="75052985" promotion_name="Limited Time Offer. Price includes 25% discount!" room_count="1" adults="2" children="0" extrabeds="0" cxl_code="126D100P_100P">
....
<prices currency="JPY" net_inclusive_amt="9948.0" refsell_amt="11250.0">
<price date="2022-06-13" net_inclusive_amt="9948.0" refsell_amt="11250.0" type="Room"/>
<price date="2022-06-14" net_inclusive_amt="9948.0" refsell_amt="11250.0" type="Room"/>
</prices>
<occupancy>
<adult count="1"/>
<child type="A: 食事及び寝具" count="1"/>
<child type="B: 子供用食事及び寝具" count="1"/>
<child type="C: 寝具のみ" count="1"/>
<child type="D: 食事寝具共になし" count="1"/>
</occupancy>
</booking>
</bookings>
</result>
| Element | Attribute | Datatype | Description |
|---|---|---|---|
| occupancy | - | - | Breakdown of occupancy per each booking |
| adult | count | numeric | Indicates the number of adults in the booking ID |
| child | type | string | Child type for Japanese properties. There are 4 types, defined as follows: A: Standard beddings and reduced portion of standard adult meal B: Standard beddings and special children’s meal C: Beddings only (no meals) D: No beddings or meals included |
| count | numeric | Indicates the number of children for each child type in the booking ID |
For more information, please see the documentation for details on GetBookingDetailsRQ elements and attributes.