Agoda Master Data
Master Data API
The Master Data API allows users to get master data of the Agoda channel.
Endpoint
GET
https://connect-sandbox.su-api.com/SUAPI/jservice/agoda/masterData.Header
-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/jsonapp-id
string
Yes
Your application ID. Required for authentication.
Authorization
string
Yes
Your API key. for authorization. Required for authentication.
Content-Type
string
Yes
Must be set to application/json.
Request
Not required
Response
{
"Status": "Success",
"Data": {
"country_list": [
{
"country_code": "MC",
"country_name": "Monaco"
},
{
"country_code": "MA",
"country_name": "Morocco"
},
{
"country_code": "JP",
"country_name": "Japan"
},
.
.
.
{
"country_code": "GG",
"country_name": "Guernsey"
}
],
"currency_list": [
{
"currency_code": "EUR",
"currency_name": "Euro"
},
{
"currency_code": "GBP",
"currency_name": "British Pound"
},
{
"currency_code": "HKD",
"currency_name": "Hong Kong Dollar"
},
.
.
.
{
"currency_code": "MRU",
"currency_name": "Ouguiya"
}
],
"property_category_list": [
{
"category_code": "28",
"category_name": "Villa"
},
{
"category_code": "29",
"category_name": "Apartment / Flat"
},
{
"category_code": "30",
"category_name": "Villa"
},
.
.
.
{
"category_code": "149",
"category_name": "Yurt"
}
],
"language_code_list": [
{
"language_code": "ar-AE",
"language_name": "Arabic - United Arab Emirates"
},
{
"language_code": "bg-BG",
"language_name": "Bulgarian - Bulgaria"
},
{
"language_code": "ca-ES",
"language_name": "Catalan - Spain"
},
{
"language_code": "zh-CN",
"language_name": "Chinese - China"
},
.
.
.
{
"language_code": "es-ES",
"language_name": "Spanish - Spain"
}
],
"cancellation_policy_list": [
{
"policy_code": "4459",
"policy_name": "Cancel 5 days prior to arrival date charge 100%, No Show 100% charge",
"description": "Any cancellation received within 5 days prior to arrival date will incur the full period charge. Failure to arrive at your hotel or property will be treated as a No-Show and no refund will be given (Property policy)."
},
{
"policy_code": "4473",
"policy_name": "Cancel 5 days prior to arrival date, the first night charge, No Show, the first night charge",
"description": "Any cancellation received within 5 days prior to arrival date will incur the first night charge. Failure to arrive at your hotel or property will be treated as a No-Show and will incur the first night charge (Property policy)."
},
{
"policy_code": "4693",
"policy_name": "Cancel 60 days prior to arrival date charge 100%, No Show 100% charge",
"description": "Any cancellation received within 60 days prior to arrival date will incur the full period charge. Failure to arrive at your hotel or property will be treated as a No-Show and no refund will be given (Property policy)."
},
.
.
.
{
"policy_code": "14053",
"policy_name": "Cancel 7 days prior to arrival date charge 90%, No Show 90% charge",
"description": "Any cancellation received within 7 days prior to arrival date will incur a charge of 90% of the booking value. Failure to arrive at your hotel or property will be treated as a No-Show and will incur a charge of 90% of the booking value (Property policy)."
}
],
"fees_policy_list": [
{
"policy_code": "12",
"policy_name": "Chinese New Year Per Adult Per Night - (Agoda Collect)",
"policy_type": "Amount"
},
{
"policy_code": "15",
"policy_name": "Chinese New Year Per Child Per Night - (Agoda Collect)",
"policy_type": "Amount"
},
{
"policy_code": "52",
"policy_name": "New Year Surcharge Per Adult Per Booking - (Agoda Collect)",
"policy_type": "Amount"
},
.
.
.
{
"policy_code": "463",
"policy_name": "City Tax Per Room Per Night (%) - (Agoda Collect)",
"policy_type": "Percentage"
}
],
"property_amenities": [
{
"facility_id": 3,
"display_code": "RESTAURANT",
"display_name": "restaurant"
},
{
"facility_id": 5,
"display_code": "ROOMSERVICE",
"display_name": "Room Service"
},
{
"facility_id": 7,
"display_code": "BAR",
"display_name": "bar"
},
.
.
.
{
"facility_id": 2373,
"display_code": "KOSHER_BREAKFAST",
"display_name": "kosher breakfast"
}
],
"room_amenities": [
{
"facility_id": 4,
"display_code": "SHOWER",
"display_name": "shower"
},
{
"facility_id": 9,
"display_code": "TELEPHONE",
"display_name": "telephone"
},
{
"facility_id": 12,
"display_code": "HAIR_DRYER",
"display_name": "hair dryer"
},
.
.
.
{
"bed_type_code": "11",
"bed_type_name": "Female Capsule"
}
],
"room_view_type_list": [
{
"room_view_code": "0",
"room_view_name": "Unknown"
},
{
"room_view_code": "1",
"room_view_name": "Ocean"
},
{
"room_view_code": "2",
"room_view_name": "Garden"
},
.
.
.
{
"room_view_code": "114",
"room_view_name": "Countryside"
}
],
"product_services_list": [
{
"service_code": "1",
"service_name": "Breakfast"
},
{
"service_code": "2",
"service_name": "Lunch"
},
{
"service_code": "3",
"service_name": "Dinner"
},
.
.
.
{
"service_code": "325",
"service_name": "Medical services discount"
}
]
},
"Message": "Master data fetched successfully"
}Success Response - Body Elements
Response Body Elements
Status string
Indicates the result of the API call.
Data object
The response data, the root element.
country_list array of objects
List of supported countries.
country_code string
ISO country code.
country_name string
Full country name.
currency_list array of objects
List of supported currencies.
currency_code string
ISO currency code (ISO 4217).
currency_name string
Currency name.
property_category_list array of objects
List of property categories.
category_code integer
Unique category code.
category_name string
Property category name.
language_code_list array of objects
List of supported languages.
language_code string
ISO language code.
language_name string
Language name.
cancellation_policy_list array of objects
List of available cancellation policies.
policy_code integer
Policy code.
policy_name string
Policy name.
description string
Policy description.
fees_policy_list array of objects
List of applicable fee policies.
policy_code integer
Policy code.
policy_name string
Policy name.
policy_type string
Type of policy.
tax_policy_list array of objects
List of applicable tax policies.
policy_code integer
Policy code.
policy_name string
Policy name.
policy_type string
Type of policy.
property_amenities array of objects
List of amenities available at the property.
facility_id integer
Facility identifier.
display_code string
Display code of the amenity.
display_name string
Display name of the amenity.
room_amenities array of objects
List of amenities available in rooms.
facility_id integer
Facility identifier.
display_code string
Display code of the amenity.
display_name string
Display name of the amenity.
image_caption_list array of objects
List of image captions and related metadata.
category_code string
Code of the image category.
category_name string
Name of the image category.
is_allowed_for_vacation_rental boolean
If the image category is allowed for the vacation rental.
bed_type_list array of objects
List of bed type options.
bed_type_code integer
Bed type code.
bed_type_name string
Bed type name.
room_view_type_list array of objects
List of available room view types.
room_view_code integer
Code of the room view.
room_view_name string
Name of the room view.
product_services_list array of objects
List of additional services or products offered.
service_code integer
Service code.
service_name string
Service name.
Message string
The message in the response.
Last updated
Was this helpful?