Download OpenAPI specification:Download
This document provides the interface specifications for the RESTful API offered by Tabiyory, enabling functionalities such as hotel search, rate inquiries, order placement, and order management. It serves as a reference for agents who have entered into a partnership agreement with our company to utilize the Tabiyory API effectively. This API is designed to streamline operations for agents by offering seamless integration into their systems, supporting efficient management of hotel-related data.
Before going live, we provide a verification environment for operation checks and integration testing with the agent's product. Once the agent's development is complete and both parties have confirmed that there are no issues in the verification environment, we will issue the necessary keys for the public API environment. The specific steps are as follows:
All API requests require the following headers for authentication
| Header | Value |
|---|---|
| Contract-No | This is a unique identifier provided by Tabiyory. It must be included in the request header for authentication. |
| Authorization | This header must be calculated for each request using the following steps |
| Content-type | application/json |
salt = unix_timestamp & 1000 (Ensure the last three digits are set to
000).Authorization header is generated by applying
the sha512 algorithm (bcrypt/SHA512) to the string:Authorization = sha512(subscription_key + salt)
Here's how to compute the Authorization header in JavaScript
javascript
const salt = Math.floor(Math.floor(Date.now() / 1000) / 1000) * 1000;
const inputString = subscriptionKey + salt;
const crypto = require('crypto-js');
const Authorization = crypto.SHA512(inputString).toString(crypto.enc.Hex);
application/json format.UTF-8.HTTP STATUS we use are below.
| CODE | Detail | Description |
|---|---|---|
| 200 | TabiyoryAPI Works well | detail status is in "result" field of each response. |
| 400 | Bad Request | no hotel, no room etc |
| 403 | Authentication Error | API authentication error |
| 500 | Internal Server Error | system error |
you can also confirm Error reason if API returns data with more detail status in "result" field.
| CODE | Description |
|---|---|
| 00 | NoError OK |
| 01 | SubscriptionError Token not available |
| 02 | SubscriptionError No subscription feature at all |
| 11 | SubscriptionError Contract has expired |
| 12 | SubscriptionError Call rate limit is exceeded |
| 20 | External API Error External Vendor replies with some error |
| 90 | InvalidRequest [ |
| 91 | NotSupportedVendorError Vendor not supported |
| 92 | SystemError Internal Server Error |
| 93 | ExecuteError Unable to execute the flow for W" |
| 99 | UnknownError Detail if any |
| Step | Description | Detail | Remarks | Update frequency |
|---|---|---|---|---|
| 1 | Retrieve Master Data | Getting geometry, currency, language master data | GET /masters/language GET /masters/currency |
Rarely |
| 2 | Retrieve Hotel & Room Data | Getting hotels list and information | GET /hotel/contents/hotels GET /hotel/contents/room |
EveryWeek |
| 3 | Retrieve Cached Data | Date-specific pricing information | GET /hotel/cache/roomsearch GET /hotel/cache/search |
EveryDay |
| 4 | Checking the Latest Pricing | Retrieves the latest availability & pricing based on selected plans and dates | GET /hotel/avail/hotel GET /hotel/avail/plan |
Each Reservation |
| 5 | Order Process | Create, Confirm, Retrive, Cancel order | POST /hotel/orders GET /hotel/orders GET /hotel/orders{order_ids}/ POST /hotel/orders/{order_ids}/confirm GET /hotel/orders/{order_ids}/voucher POST /hotel/orders/{order_ids}/cancel |
Each Reservation |
| 6 | Deposit Balance & History | Check the current deposit balance and transaction history | GET /common/balance GET /common/balance/history |
As Needed |
About the Rate Types We Provide
For further details, please refer to the descriptions of each API field.
Since the API provides all the information necessary for product searches, we strongly recommend that agents build their own product databases. To save products to the database, you need to call the following APIs
Regarding content, hotel lists or room information will be returned as response data, and all product information can be obtained by paging. Regular updates to the content cached in the database are recommended to ensure that the latest information can be provided to end users.
You can obtain property_id, city_code, etc., from the
/contents and /master endpoint, which will be required for product
searches and making an order.
You can check rate plans for rooms by using the following cache data endpoints
When creating an order, always check the availability of the room and rate type.
If you have the room_product_key, room_product_code, and
vendor_code, you can directly check the latest status of the cache data.
When placing an order, be sure to check availability to get the latest information When you call this APL, you need to set the condition including check-in/check-out date, property_id and number of guest.
Keep the avail_uniq_id and room_id returned in the response, as these will be
required when placing an order.
Once you have confirmed availability, you can create an order using
Before placing an order, use GET /balance to ensure sufficient balance.
If you wish to get the balance history, use GET /balance/history.
Keep the order_uid returned when the order is created. This will be required for confirming
or checking the status of the order.
After placing an order, you can confirm it using the following methods
To get a voucher for the confirmed order, use
To cancel an order, use
| STATUS | Description | Remarks |
|---|---|---|
| Provisional Order | At this stage, the order is not yet confirmed. | Please note that some products may be "Instantly Confirmed Orders." |
| Cancellation Before Confirmation | If the order is not confirmed by the deadline or is manually canceled before confirmation | no cancellation charges will apply. |
| Confirmation | Once confirmed, the cancellation policy will be enforced for any cancellations. | After confirmation, we issue the Invoice and Voucher. |
| Cancellation After Confirmation | Once confirmed, the cancellation policy will be enforced for any cancellations. | A cancellation fee may apply based on the cancellation policy. |
| Regarding Changes | Changes cannot be made. | Please cancel and rebook if necessary. |
| Cancellation Due to Operator Circumstances | The operator may cancel the order due to their own reasons, resulting in a contract cancellation. | This is our disclaimer. |
get generic information like countries, areas, currencies. before access to our various API, need to get all these data.
Retrieve a list of all countries that we support. This API provides country codes, names, region codes, and other details relevant for other API calls.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "countries": [
- {
- "code": "JP",
- "name": "Japan",
- "region_code": "VA_1",
- "region_name": "ASIA",
- "nationality": "Y"
}
]
}
Retrieve a list of all areas within a specified region, country, and optionally a specific prefecture. This API provides detailed geographical hierarchy, including regions, prefectures, cities, and sub-areas.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| region_code
required
|
string
Example: region_code=VA_1
region code of the target area. |
| country_code
required
|
string
Example: country_code=JP
country code of the target area. |
| prefecture_code |
string
Example: prefecture_code=VST_01
State or Prefecture code of the target area. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "regions": [
- {
- "region_code": "VA_1",
- "region_name": "Hokkaido",
- "prefectures": [
- {
- "prefecture_code": "VST_01",
- "name": "Hokkaido",
- "cities": [
- {
- "city_code": "VCT_CTSE.",
- "name": "Chitose Airport/Shikotsu",
- "subarea_type": 1,
- "subarea_code": "VSAT_TKYO01"
}
]
}
], - "countries": [
- {
- "country_code": "JP",
- "name": "JAPAN"
}
]
}
]
}
Retrieve a list of all currencies supported by the API. This includes the currency code and the currency name that can be used in other API requests.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "currencies": [
- {
- "currency_code": "JPY",
- "name": "Japanese Yen"
}
]
}
Retrieve a list of all supported languages, including the language code, name, and a description in the specified language.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "languages": [
- {
- "language_code": "ja-JP",
- "name": "Japanese",
- "description": "string"
}
]
}
get hotel's static information. It shoule get these data periodically to update hotel database.
Retrieve detailed information about hotels, including their categories, rankings, location, facilities, rooms, issues, media, and nearby points of interest. This data can be filtered by country, prefecture, and hotel-specific attributes.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| size |
number
Default: 20
Example: size=20
Number of items returned per page |
| page |
number
Default: 1
Example: page=1
Current page offset. |
| country_code
required
|
string
Example: country_code=JP
Country code of the target hotel (e.g., "JP" for Japan). Refer to the list of supported country codes. |
| prefecture_code |
string
Example: prefecture_code=VST_01
State/Prefecture code of the target hotel. This is optional. If not provided, hotels from all prefectures are returned. |
| property_ids |
string
Example: property_ids=1,2,3
List of hotel IDs to filter results. If not provided, all hotels are returned. |
| fields |
string
Example: fields=facility,media,room
Specify attributes to filter by (e.g., "facility", "media", "room"). Use "all" to return all attributes. |
| last_update_time |
string <date>
Example: last_update_time=2020-03-03
The last update date in the format YYYY-MM-DD. This helps filter hotels updated since a particular date. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "hotels": [
- {
- "property_id": "824510",
- "name": "Hotel Tabiyory",
- "category": [
- {
- "code": "1",
- "name": "Luxury"
}
], - "ranking": 3,
- "latitude": 139.77148,
- "longitude": 35.7096,
- "country": {
- "country_code": "JP",
- "name": "JAPAN"
}, - "prefecture": {
- "prefecture_code": "VST_01",
- "name": "Hokkaido"
}, - "city": {
- "city_code": "VCT_CTSE",
- "name": "Chitose Airport/Shikotsu"
}, - "subarea": {
- "subarea_code": "VSTA_TKYO01",
- "name": "Central of Tokyo"
}, - "postal_code": "160-0000",
- "address": {
- "content": "Shinjuku, Tokyo"
}, - "telephone": "+81399999999",
- "email": "aaa@aaa.com",
- "description": "string",
- "issues": [
- {
- "alternative": true,
- "date_from": "2025-01-01",
- "date_to": "2025-12-31",
- "description": "No extra bed available.",
- "issue_code": "30770",
- "issue_type": "1",
- "order": "1"
}
], - "media": [
- {
- "images": [
- {
- "room_id": "string",
- "room_type": "string",
- "order": 1,
- "type": {
- "code": "string",
- "description": "string"
}
}
]
}
], - "facility_info": [
- {
- "code": 1001,
- "group_code": 0,
- "name": "Free Wi-Fi",
- "application_type": "Room Facility",
- "description": "Free Wi-Fi available in all rooms.",
- "age_from": 18,
- "age_to": 80,
- "time_from": "08:00",
- "time_to": "22:00",
- "is_fee": true,
- "amount": 500,
- "voucher": true
}
], - "interest_points": [
- {
- "distance": 10,
- "facility_code": 110100020,
- "facility_group_code": 2,
- "fee": true,
- "poi_name": "Osaka Castle"
}
], - "terminals": [
- {
- "description": "biggest terminal in Tokyo",
- "distance": 10,
- "name": "Tokyo Station",
- "terminal_code": "OSAKA-Station",
- "terminal_type": "station"
}
], - "last_update_time": "2019-08-24",
- "rooms": [
- {
- "room_id": "78",
- "type": {
- "room_type_code": "N10",
- "room_name": "SGL",
- "description": "TWN/DBL",
- "content": "CityView",
- "language_code": "ja-JP"
}, - "description": "A single room with a city view.",
- "attention": "NO SMOKING",
- "max_adults": 3,
- "max_children": 1,
- "max_pax": 3,
- "min_adults": 1,
- "min_pax": 1
}
]
}
], - "pagination": {
- "total": 155,
- "page": 1,
- "size": 20
}
}
This API retrieves detailed information about the rooms associated with a specific hotel. It includes information such as room types, descriptions, maximum and minimum occupancy, amenities, and special notes. The API supports pagination and allows filtering results by language and hotel ID. Use this endpoint to fetch room data for integration into hotel booking or management systems.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| size |
number
Default: 20
Example: size=20
Number of items returned per page |
| page |
number
Default: 1
Example: page=1
Current page offset. |
| property_id
required
|
string
Example: property_id=824510
Unique identifier for the hotel. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "property_id": "824510",
- "rooms": [
- {
- "room_id": "78",
- "type": {
- "room_type_code": "N10",
- "room_name": "SGL",
- "description": "TWN/DBL",
- "content": "CityView",
- "language_code": "ja-JP"
}, - "description": "A single room with a city view.",
- "attention": "NO SMOKING",
- "max_adults": 3,
- "max_children": 1,
- "max_pax": 3,
- "min_adults": 1,
- "min_pax": 1,
- "amenity": [
- {
- "id": "1001001",
- "name": "Breakfast",
- "extra_data": "Vegetarian options available."
}
]
}
], - "pagination": {
- "total": 155,
- "page": 1,
- "size": 20
}
}
get reference price information of each hotel. It's cache data we collect. This cached information helps you to understand pricing information and compare hotels.
This API searches cached price information for hotel rooms based on provided conditions, including room configuration, check-in date, and number of nights. It retrieves detailed information such as cancel policies, vendor responses, room details, and pricing.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| currency_code
required
|
string
Enum: "JPY" "USD" "KRW" "CNY" "EUR"
Example: currency_code=JPY
set currency code to use in API calls |
| property_id
required
|
string
Example: property_id=824510
Hotel ID |
| rooms
required
|
string
Example: rooms=1-0-;1-1-2;2-2-5,8
Room configuration in the format adult-child-childages. |
| check_in
required
|
string <date>
Example: check_in=2024-11-25
Check-in date (YYYY-MM-DD). |
| nights
required
|
integer
Example: nights=1
Number of nights to stay. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "check_in": "2024-11-25",
- "nights": 1,
- "hotels": [
- {
- "property_id": "824510",
- "order_type": "2",
- "hotel_attentions": [
- "string"
], - "vendor_response": [
- {
- "vendor": {
- "web_code": "P2",
- "all_cancel": "1",
- "order": [
- {
- "remarks": "[\"Changes may be requested before the cancellation deadline.\"]",
- "conditions": "[\"Changes are not allowed after 2024/10/11 17:00 JST.\"]"
}
], - "cancel_policy": [
- {
- "show_flag": "1",
- "apply_datetime": "2019-08-24T14:15:22Z",
- "charge_type": "1",
- "rules": {
- "date": "20",
- "net": 35630,
- "gross": 39600,
- "description": "From 2024/10/12 17:00 JST, the cancellation fee is 35,630 yen."
}
}
], - "room": {
- "room_product_key": "13579/320652426/387145373/37321",
- "room_product_code": "13579_320652426",
- "room_id": "1",
- "attention": "NO SMOKING",
- "description": "CITY View",
- "order_type": "2",
- "type": {
- "code": "N10",
- "name": "SGL",
- "room_no": "1"
}, - "charge": {
- "room_no": "1",
- "extra_data": [
- {
- "name": null,
- "value": null
}
]
}, - "meal": [
- {
- "name": "1",
- "days": [
- null
]
}
], - "meal_message": "Free breakfast"
}
}
}
]
}
]
}
This API retrieves the lowest available rates for hotels based on location (city or subarea), room configurations, check-in date, and number of nights. It supports pagination and provides detailed pricing information, including NET and GROSS values.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| currency_code
required
|
string
Enum: "JPY" "USD" "KRW" "CNY" "EUR"
Example: currency_code=JPY
set currency code to use in API calls |
| city_code |
string
Example: city_code=VCT_TKYO
Location code (city code) of the target area. |
| subarea_code |
string
Example: subarea_code=VSAT_TKYO01
Subarea code (specific area within a city). |
| rooms
required
|
string
Example: rooms=1-0-;1-1-2;2-2-5,8
Room configurations in the format adult-child-childages. |
| check_in
required
|
string <date>
Example: check_in=2020-03-03
Check-in date (YYYY-MM-DD). |
| nights
required
|
integer
Example: nights=1
Number of nights to stay. |
| size |
number
Default: 20
Example: size=20
Number of items returned per page |
| page |
number
Default: 1
Example: page=1
Current page offset. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "check_in": "2020-03-03",
- "nights": 1,
- "hotels": [
- {
- "property_id": "824510",
- "order_type": "2",
- "net_value": 22630,
- "gross_value": 25200,
- "net_ok": 22630,
- "gross_ok": 39600,
- "net_currency_code": "JPY",
- "gross_currency_code": "JPY",
- "room_product_key": "13579/231326/567119/37321",
- "room_product_code": "13579_231326",
- "vendor_code": "AGD",
- "extra_data": "{\"additionalField\":\"value\"}"
}
], - "pagination": {
- "total": 155,
- "page": 1,
- "size": 20
}
}
This API checks the realtime availability of the specific hotel-plan based on specified conditions, including check-in date, room configurations, and number of nights. It provides details about pricing, cancellation policies, and other vendor-specific information.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| currency_code
required
|
string
Enum: "JPY" "USD" "KRW" "CNY" "EUR"
Example: currency_code=JPY
set currency code to use in API calls |
| property_id
required
|
string
Example: property_id=824510
Hotel ID |
| rooms
required
|
string
Example: rooms=1-0-;1-1-2;2-2-5,8
Room configurations in the format "adult-child-childages;". |
| check_in
required
|
string <date>
Example: check_in=2020-03-03
Check-in date (YYYY-MM-DD). |
| nights
required
|
integer
Example: nights=1
Number of nights to stay. |
| only_avail
required
|
string
Example: only_avail=1
Availability filter
|
| no_finalbook |
string
Example: no_finalbook=1
Indicate if the search is not for final booking purposes.
|
| extra_param |
string
Example: extra_param=field_name-value,fieldname-value
Additional parameters in the format [field_name-value,fieldname-value,...]. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "avail_uniq_id": "42",
- "hotels": [
- {
- "property_id": "707021",
- "order_type": "2",
- "gross_value": 39600,
- "gross_currency_code": "JPY",
- "gross_ok": 39600,
- "net_value": 35630,
- "net_currency_code": "JPY",
- "net_ok": 35630,
- "hotel_attentions": [
- "string"
], - "vendor_response": [
- {
- "vendor": {
- "web_code": "P2",
- "all_cancel": "2",
- "book": {
- "remarks": [
- "Changes allowed before 2024/10/12."
], - "conditions": [
- "Changes not allowed after 2024/10/12 17:00 JST."
]
}, - "cancel_policy": [
- {
- "show_flag": "1",
- "apply_datetime": "2019-08-24T14:15:22Z",
- "charge_type": "1",
- "rules": [
- {
- "date": null,
- "net": null,
- "gross": null,
- "description": null
}
]
}
], - "room": {
- "room_product_key": "13579/320652426/387145373/37321",
- "room_product_code": "13579_320652426",
- "room_id": "1",
- "attention": "NO SMOKING",
- "description": "CITY View",
- "order_type": "2",
- "type": {
- "code": "N10",
- "name": "SGL",
- "room_no": "1"
}, - "charge": {
- "room_no": "1",
- "extra_data": [
- {
- "name": null,
- "value": null
}
]
}, - "meal": [
- {
- "name": "1",
- "days": [
- null
]
}
], - "meal_message": "Free breakfast"
}
}
}
]
}
]
}
This API checks the realtime availability of the specific hotel based on specified conditions, including check-in date, room configurations, and number of nights. It provides details about pricing, cancellation policies, and other vendor-specific information.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| currency_code
required
|
string
Enum: "JPY" "USD" "KRW" "CNY" "EUR"
Example: currency_code=JPY
set currency code to use in API calls |
| property_id
required
|
string
Example: property_id=824510
Hotel ID |
| rooms
required
|
string
Example: rooms=1-0-;1-1-2;2-2-5,8
Room configurations in the format "adult-child-childages;". |
| check_in
required
|
string <date>
Example: check_in=2020-03-03
Check-in date (YYYY-MM-DD). |
| nights
required
|
integer
Example: nights=1
Number of nights to stay. |
| only_avail
required
|
string
Example: only_avail=1
Availability filter e.g., 0=all, 1=available only |
| no_finalbook |
string
Example: no_finalbook=1
Indicate if the search is not for final booking purposes.1=finalboon,0=not final |
| extra_param |
string
Example: extra_param=field_name-value,fieldname-value
Additional parameters in the format [field_name-value,fieldname-value,...]. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "avail_uniq_id": "42",
- "hotels": [
- {
- "property_id": "707021",
- "order_type": "2",
- "gross_value": 39600,
- "gross_currency_code": "JPY",
- "gross_ok": 39600,
- "net_value": 35630,
- "net_currency_code": "JPY",
- "net_ok": 35630,
- "hotel_attentions": [
- "string"
], - "vendor_response": [
- {
- "vendor": {
- "web_code": "P2",
- "all_cancel": "2",
- "book": {
- "remarks": [
- "Changes allowed before 2024/10/12."
], - "conditions": [
- "Changes not allowed after 2024/10/12 17:00 JST."
]
}, - "cancel_policy": [
- {
- "show_flag": "1",
- "apply_datetime": "2019-08-24T14:15:22Z",
- "charge_type": "1",
- "rules": [
- {
- "date": null,
- "net": null,
- "gross": null,
- "description": null
}
]
}
], - "room": {
- "room_product_key": "13579/320652426/387145373/37321",
- "room_product_code": "13579_320652426",
- "room_id": "1",
- "attention": "NO SMOKING",
- "description": "CITY View",
- "order_type": "2",
- "type": {
- "code": "N10",
- "name": "SGL",
- "room_no": "1"
}, - "charge": {
- "room_no": "1",
- "extra_data": [
- {
- "name": null,
- "value": null
}
]
}, - "meal": [
- {
- "name": "1",
- "days": [
- null
]
}
], - "meal_message": "Free breakfast"
}
}
}
]
}
]
}
This API allows submitting a hotel order for booking using the provided availability ID. It validates guest information, room details, and other booking parameters.
|
object (common)
|
|
| avail_uniq_id |
string
Availability unique ID obtained from the availability API. |
|
object
Information about the booking holder. |
|
| vendor_reference |
string <= 50 characters
Vendor reference for the booking. |
|
object
Hotel information for the booking. |
|
| checkin |
string <date>
Check-in date (YYYY-MM-DD). |
| checkout |
string <date>
Check-out date (YYYY-MM-DD). |
| nights |
integer [ 1 .. 10 ]
Number of nights to stay. |
|
Array of objects
List of rooms to book. |
|
|
Array of objects
Additional parameters for the booking. |
{- "common": {
- "language": "ja-JP"
}, - "avail_uniq_id": "27",
- "holder": {
- "surname": "TABIYORY",
- "name": "TARO",
- "title": "MR",
- "email": "test@tabiyory.com",
- "address": "string",
- "zip": "224-0041",
- "telephones": [
- "0804629940"
], - "nationality": "CN"
}, - "vendor_reference": "APWA#04352",
- "hotel": {
- "property_id": "824510"
}, - "checkin": "2024-09-06",
- "checkout": "2024-09-07",
- "nights": 1,
- "rooms": [
- {
- "id": "1",
- "guests": [
- {
- "surname": "TABITORY",
- "firstname": "TARO",
- "age": 0,
- "sex": "1",
- "child_flag": "0",
- "holder_flag": "1"
}
], - "special_request": [
- {
- "name": "Early Checkin",
- "value": "2024-09-06T09:00Z"
}
]
}
], - "extra_param": [
- {
- "group": "extra",
- "name": "extra name",
- "value": "extra value"
}
]
}
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "ordering": {
- "order_uid": "12",
- "avail_uniq_id": "42",
- "itn_no": "1",
- "creation_date": "2024-09-06T10:00:00Z",
- "vendor_reference": "APWA#04352",
- "order_status": "2",
- "net_currency_code": "JPY",
- "currency_code": "JPY",
- "total_selling_rate": 23000,
- "total_net": 21000,
- "holder": {
- "surname": "TABIYORY",
- "name": "TARO",
- "title": "MR",
- "email": "test@tabiyory.com",
- "address": "Tokyo, Japan"
}, - "hotels": [
- {
- "property_id": "824510",
- "name": "Hotel Tabiyory",
- "order_type": "1",
- "vendor": "AGD",
- "room": {
- "room_product_key": "13579/320652426/387145373/37321",
- "room_product_code": "13579_320652426",
- "room_id": "1",
- "attention": "NO SMOKING",
- "description": "City view with balcony.",
- "order_type": "2",
- "type": {
- "code": "N10",
- "name": "SGL",
- "room_no": "101"
}, - "charge": {
- "net": 35630,
- "gross": 39600
}
}, - "cancel_policy": [
- {
- "show_flag": "1",
- "apply_datetime": "2019-08-24T14:15:22Z",
- "charge_type": "1",
- "rules": {
- "date": "20",
- "net": 35630,
- "gross": 39600,
- "description": "Cancellation fee applies from 2024/10/12 17:00 JST."
}
}
], - "meal": [
- {
- "code": "1",
- "days": [
- "2"
]
}
], - "meal_message": "Free breakfast"
}
]
}
}
This API retrieves detailed information about a specific hotel order, including its status, pricing, holder details, and associated hotel and room data.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| order_uid
required
|
string
Example: order_uid=10
Unique ID of the order to retrieve. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "order_uid": "10",
- "itinerary_info": "1",
- "vendor_reference": "APWA#04352",
- "ordering": {
- "order_status": "2",
- "gross_amount": 23000,
- "net_amount": 21000,
- "currency_code": "JPY",
- "vendor_code": "AGD",
- "holder": {
- "surname": "TABIYORY",
- "name": "TARO",
- "title": "MR",
- "email": "test@tabiyory.com",
- "address": "Tokyo, Japan"
}, - "hotels": [
- {
- "property_id": "824510",
- "name": "Hotel Tabiyory",
- "order_type": "1",
- "vendor": "AGD",
- "room": {
- "room_product_key": "13579/320652426/387145373/37321",
- "room_product_code": "13579_320652426",
- "room_id": "1",
- "attention": "NO SMOKING",
- "description": "City view with balcony.",
- "order_type": "2",
- "type": {
- "code": "N10",
- "name": "SGL",
- "room_no": "101"
}
}, - "cancel_policy": [
- {
- "show_flag": "1",
- "apply_datetime": "2019-08-24T14:15:22Z",
- "charge_type": "1",
- "rules": {
- "date": "20",
- "net": 35630,
- "gross": 39600,
- "description": "Cancellation fee applies from 2024/10/12 17:00 JST."
}
}
], - "meal": [
- {
- "code": "1",
- "days": [
- "2"
]
}
], - "meal_message": "Free breakfast included"
}
], - "extra_data": [
- {
- "group": "string",
- "id": "string",
- "value": "string"
}
]
}
}
This API retrieves a list of hotel orders based on various filtering parameters such as date range, hotel ID, destination, and order status. The response includes order details and associated metadata.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| size |
number
Default: 20
Example: size=20
Number of items returned per page |
| page |
number
Default: 1
Example: page=1
Current page offset. |
| order_status |
string
Example: order_status=ALL
Filter the order list by status:
|
| country_code |
string
Example: country_code=country1,country2
Filter the order list by hotel country code. Multiple values can be separated by commas. |
| prefecture_code |
string
Example: prefecture_code=destination1,destination2
Filter the order list by hotel destination code. Multiple values can be separated by commas. |
| property_id |
string
Example: property_id=hotel1,hotel2
Filter the order list by hotel property ID. Multiple values can be separated by commas. |
| start
required
|
string <date>
Example: start=2020-03-03
Start date for the booking range (YYYY-MM-DD). |
| end
required
|
string <date>
Example: end=2020-03-10
End date for the booking range (YYYY-MM-DD). |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "orderings": [
- {
- "order_uid": "12",
- "vendor_reference": "APWA#04352",
- "property_id": "824510",
- "check_in": "2024-09-06",
- "check_out": "2024-09-07",
- "city_code": "VCT_CTSE",
- "city_name": "Chitose Airport/Shikotsu",
- "creation_date": "2024-09-05T12:00:00Z",
- "order_status": "2",
- "sub_status": "0",
- "operation_status": "3",
- "confirmed_itns": 1,
- "gross_amount": 23000,
- "net_amount": 21000,
- "currency_code": "JPY",
- "holder": {
- "name": "TARO",
- "surname": "TABIYORY"
}, - "extra_data": {
- "additionalField": "value"
}
}
], - "pagination": {
- "total": 155,
- "page": 1,
- "size": 20
}
}
This API is used to confirm a hotel order, including payment information and final status updates.
|
object (common)
|
|
| order_uid |
string
Unique ID of the order to confirm. |
|
object
Payment information associated with the order. |
{- "common": {
- "language": "ja-JP"
}, - "order_uid": "20",
- "payment": {
- "date": "2024-09-06T12:00:00Z",
- "method": "1",
- "amount": 10000
}
}
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "order_uid": "12",
- "vendor_reference": "APWA#04352",
- "final": {
- "status": "00",
- "limit_date": "2024-09-10T23:59:59Z"
}, - "offset_date": {
- "transfer": "2024-09-09T23:59:59Z"
}, - "charges": [
- {
- "content": "Current",
- "amount": 51190
}
]
}
This API retrieves PDF Voucher about a specific hotel order.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| type
required
|
string
Example: type=Voucher
Type of Voucher |
| order_uid
required
|
string
Example: order_uid=10
Unique ID of the order to retrieve. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "order_uid": "10",
}
This API handles cancellation of hotel orders. Depending on the cancellation_flag, it
can either confirm cancellation details or perform the cancellation.
|
object (common)
|
|
| order_uid |
string
Unique ID of the order to be canceled. |
| cancellation_flag |
string
Specifies the action to perform:
|
{- "common": {
- "language": "ja-JP"
}, - "order_uid": "12",
- "cancellation_flag": "1"
}
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "cancel": {
- "order_uid": "12",
- "process_status": "2",
- "finalize": "1",
- "currency_code": "JPY",
- "cancel_charge": 50000,
- "refund_amount": 20000,
- "itineraries": [
- {
- "itinerary_no": "1"
}
], - "payment": {
- "status": "1",
- "vendor_data": "Vendor-specific information"
}, - "cancel_condition": {
- "vendor_data": "JSON DATA"
}, - "date": "2024-09-06T23:59:59Z"
}
}
This API retrieves balance amount of the agent. Before making order, please confirm it is enough amount for making the order.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "balances": [
- {
- "amount": 986765,
- "currency": "JPY"
}
]
}
This API retrieves detailed information about balance history, including its status, pricing, date etc.
| language_code
required
|
string
Enum: "ja-JP" "zh-CHS" "zh-CHT" "zh-CN" "zh-HK" "zh-MO" "zh-SG" "zh-TW"
Example: language_code=ja-JP
set locale code. need ISO639 and ISO3166-1 |
| size |
number
Default: 20
Example: size=20
Number of items returned per page |
| page |
number
Default: 1
Example: page=1
Current page offset. |
{- "result": {
- "response_code": "00",
- "message": "text string."
}, - "transactions": [
- {
- "id": "ac-aa2024060112345",
- "amount": 50000,
- "currency": "JPY",
- "transaction_type": "SUBTRACTED",
- "create_at": 1716235851
}
], - "pagination": {
- "total": 155,
- "page": 1,
- "size": 20
}
}