Agoda Master Data

NOTE

Kindly refer to the Master Data response to fetch all the required information.

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/json

Header	Type	Required	Description
app-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.

Will be "Success" for successful operations.

Will be always "Fail" in case of an error response.

---

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.