Su API Documentation
  • Su Overview
    • Su API Introduction
  • Su Channel Manager
    • Getting Started
      • Certification
      • Authentication
    • Content
      • Property
      • Room Type
      • Rate Plan
      • Listing
        • Property Listing
        • Room Type Listing
        • Rate Plan Listing
        • Delete Property Listing
      • Image API
        • Create Images
        • Retrieve Images
        • Associate Images
    • Booking.com Content API
      • Booking.com
        • Contract - Introduction
          • Create Contract
          • Link/Retrieve Contract
          • Update Contract
          • Resend Contract
        • Property Management
          • Property Statuses
          • Property Detail
            • Create Property
            • Retrieve Property
            • Update Property
          • Contact Details
            • Set Contact
            • Retrieve Contact
            • Contact Profile Types
          • Property Settings
            • Retrieve Property Settings
            • Retrieve Property Settings Damage Programme
            • Retrieve City Tax Category For Property Settings
            • Create / Update Property Settings
            • Create / Update Property Settings - Specific Setting
          • Property Profile
            • Set Profile
            • Retrieve Property Profile
            • Set Hotelier Message
            • Retrieve Hotelier Message
            • Remove Hotelier-Message
          • Booking.com Property Status
            • Property Status Check
            • Property Status Open
            • Property Status Closed
          • Property Key Collection
            • Set CheckIn Methods
            • Retrieve CheckIn Method
            • Retrieve All Stream Variation
        • Images
          • Create Image
          • Retrieve All Images
          • Update Image Tags
          • Delete Image
          • Retrieve Associate Images
          • Associate Image
          • Unassociate Image
          • Ordering Image
          • Smart Ordering Image
          • Show Image
          • Retrieve Property Pending Photos based on photo-batch-id
          • Retrieve Image Tags
        • Facilities
          • Create/Update Facility
          • Retrieve Set Facility of Property and Room
          • Retrieve Supported Facilities
        • Property/Room Charges
          • Retrieve Property Charge Meta
          • Retrieve Property Charges
          • Retrieve Room Charges
          • Create Property Charges
        • Rate Plan
          • Set Rateplan
          • Retrieve Rateplan
      • Room API
        • Room Meta API
        • Room Set (Create/Update) API
        • Room Retrieve API
        • Room Deactivate API
      • Policies API
        • Create/Update Policies
        • Retrieve Policies
      • Bathroom API
        • Set Bathroom (Create and Update)
        • Remove/Disable Bathroom
        • Retrieve Bathroom
      • Product API
        • Product Meta
        • Product List
        • Product Create
        • Product Modify
        • Product Remove
        • Product Map Create (Room Based)
        • Product Map Modify (Room Based)
        • Product Map Create (Occupancy Based)
        • Product Map Modify (Occupancy Based)
        • Product Unmap
      • Property and Room License
        • Property License Retrieve All Rule (Without property id)
        • Property License Retrieve Rule (With property id)
        • Sending License Information of Property
        • Retrieve License Information of Property
        • Sending License Information of Room
        • Retrieve License Information of Room
      • BCIO (Booking.com Check-In / Check-Out Times)
      • PCT (Property Class Type Codes)
      • BCJT (Booking.com Job Titles)
      • PTT (Phone Technology Type Codes)
      • BCL (Booking.com Language Codes)
      • Currency Codes/Names
      • Country Codes/Names
      • BCPT (Booking.com Payment Type Codes)
    • Rates and Availability
    • Inventory Control
    • Reservations
      • New/Modified/Requested/Cancelled Retrievals
        • Request for Reservation Information
        • Response of Reservation Information
      • Reservation Using Push API
        • Reservations Notification Push
        • PUSH API Method
      • Reservation Notification
      • Request Booking
        • Accept/Confirm Request Booking
        • Deny/Cancel Request Booking
      • Booking Repull
        • List of Bookings
        • Refetch Booking
    • Logs
      • Update Logs
      • Failed Channel Logs
      • Rates & Inventory Logs (Future Date)
      • Bulk Rates & Inventory Logs (Future Date)
      • Resync OTA Updates (Failed)
      • OTA Rateplan Pull API
    • Users
      • Global Users
      • Chain Users
    • Channel Mapping Widget API
      • Generate a Token
      • Mapping Script
    • Reviews
    • Messaging
    • Reporting
      • Reporting - No Show (Booking.com & Goibibo)
      • Reporting - Invalid CC (Booking.com)
      • Reporting - Cancellation Due to Invalid CC (Booking.com)
      • Bulk ARI Update
      • Marketing Insight API - Booking.com
    • AirBnB
      • Cancel Reservation
        • Retrieve AirBnB Cancel Reservation Details API
        • Final AirBnB Cancel Reservation API
      • Notification
      • Trip Issue
    • My Booking Site
      • Confirm Reservation
      • Cancel Reservation
  • Su Token
    • Su Token - Introduction
    • Su Token - Authentication
    • Partner
    • Card
      • Card API
      • Card View API
      • Charge API
      • Card Collection
        • Get CC Collection (Generate Link)
        • Check Status of CC Collection
      • WIDGET
        • CC Collection Using Widget
  • Codes
    • Room Type Codes
    • Language Codes
    • Country Codes
    • Phone Technology Type Codes
    • Meal Plan Codes
    • Currency Codes
    • Channel or OTA Codes
    • Credit Card Type Codes
    • Time Zones
    • Error Codes
  • Versioning
  • Glossary of Terms
Powered by GitBook

STAAH Limited. 2024 © All Rights Reserved.

On this page
  • Endpoint
  • Sample Response

Was this helpful?

Export as PDF
  1. Su Channel Manager
  2. Booking.com Content API
  3. Product API

Product Meta

PreviousProduct APINextProduct List

Last updated 3 months ago

Was this helpful?

This endpoint retrieves detailed metadata for various value-added services and meal plan types available for a product.


Endpoint

GET

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/product/meta

Sample Response

Sample Success Response - 1

{
    "Status": "Success",
    "Data": {
        "value_adds": [
            {
                "id": 1001,
                "category": "Transportation",
                "type": "Parking",
                "name": "Self: 1 car Per room - per stay",
                "attributes": []
            },
            {
                "id": 1002,
                "category": "Transportation",
                "type": "Parking",
                "name": "Valet: 1 car Per room - per stay",
                "attributes": []
            },
            {
                "id": 6001,
                "category": "Transportation",
                "type": "Airport transfer",
                "name": "Roundtrip",
                "attributes": []
            },
            {
                "id": 6002,
                "category": "Transportation",
                "type": "Airport transfer",
                "name": "One way",
                "attributes": []
            },
            {
                "id": 2001,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Daily Credit Per adult - No Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2002,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Daily Credit Per adult - Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2003,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Daily Credit Per room - No Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2004,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Daily Credit Per room - Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2009,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Services Discount",
                "attributes": [
                    {
                        "name": "Percentage",
                        "dataType": "double",
                        "description": "Percentage discount applied. Must be greater than 0 and less than or equal to 100.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2013,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Per stay credit - per adult",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2014,
                "category": "Food and Beverage (F&B)",
                "type": "Credit or discount",
                "name": "Per stay credit - per room",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 9001,
                "category": "Food and Beverage (F&B)",
                "type": "Bottle of wine",
                "name": "Bottle of wine",
                "attributes": []
            },
            {
                "id": 9002,
                "category": "Food and Beverage (F&B)",
                "type": "Bottle of champagne",
                "name": "Bottle of champagne",
                "attributes": []
            },
            {
                "id": 2005,
                "category": "Property Services (PS)",
                "type": "Credit or discount",
                "name": "Daily Credit Per adult - No Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2006,
                "category": "Property Services (PS)",
                "type": "Credit or discount",
                "name": "Daily Credit Per adult - Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2007,
                "category": "Property Services (PS)",
                "type": "Credit or discount",
                "name": "Daily Credit Per room - No Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2008,
                "category": "Property Services (PS)",
                "type": "Credit or discount",
                "name": "Daily Credit Per room - Daily Accrual",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2010,
                "category": "Property Services (PS)",
                "type": "Discount",
                "name": "Discount",
                "attributes": [
                    {
                        "name": "Percentage",
                        "dataType": "double",
                        "description": "Percentage discount applied. Must be greater than 0 and less than or equal to 100.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2011,
                "category": "Property Services (PS)",
                "type": "Credit or discount",
                "name": "Per stay credit - per adult",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 2012,
                "category": "Property Services (PS)",
                "type": "Credit or discount",
                "name": "Per stay credit - per room",
                "attributes": [
                    {
                        "name": "CurrencyCode",
                        "dataType": "string",
                        "description": "Specifies the currency code for the selected amount. Default: Uses property's currency code.",
                        "required": false
                    },
                    {
                        "name": "Amount",
                        "dataType": "double",
                        "description": "Specifies an estimated worth of the value add included in the rate.",
                        "required": true
                    }
                ]
            },
            {
                "id": 5001,
                "category": "Internet Services (PS)",
                "type": "HighSpeed Internet",
                "name": "Per stay - per room",
                "attributes": []
            },
            {
                "id": 3001,
                "category": "Frontdesk services",
                "type": "Early Check-in",
                "name": "Early Check-in",
                "attributes": [
                    {
                        "name": "Hour",
                        "dataType": "int",
                        "description": "Specifies the minimum hour of the day the check-in is allowed.",
                        "required": true
                    }
                ]
            },
            {
                "id": 3002,
                "category": "Frontdesk services",
                "type": "Late Check-out",
                "name": "Late Check-out",
                "attributes": [
                    {
                        "name": "Hour",
                        "dataType": "int",
                        "description": "Specifies the maximum hour of the day the check-out is allowed.",
                        "required": true
                    }
                ]
            },
            {
                "id": 3003,
                "category": "Frontdesk services",
                "type": "Late Check-in",
                "name": "Late Check-in",
                "attributes": [
                    {
                        "name": "Hour",
                        "dataType": "int",
                        "description": "Specifies the maximum hour of the day the check-in is allowed.",
                        "required": true
                    }
                ]
            },
            {
                "id": 4001,
                "category": "Wellness",
                "type": "Spa",
                "name": "Unlimited access Per day - per adult",
                "attributes": []
            },
            {
                "id": 4002,
                "category": "Wellness",
                "type": "Spa",
                "name": "Hourly access Per day - per adult",
                "attributes": [
                    {
                        "name": "Hour",
                        "dataType": "int",
                        "description": "Specifies the number of hours allowed at the spa per day, per adult.",
                        "required": true
                    }
                ]
            },
            {
                "id": 4003,
                "category": "Wellness",
                "type": "Massage",
                "name": "N minutes Per stay - per adult",
                "attributes": [
                    {
                        "name": "Minute",
                        "dataType": "int",
                        "description": "Specifies the duration of massage service in minutes included per stay, per adult.",
                        "required": true
                    }
                ]
            },
            {
                "id": 7001,
                "category": "Activities",
                "type": "Safari game drive",
                "name": "Per day - per room",
                "attributes": []
            },
            {
                "id": 7002,
                "category": "Activities",
                "type": "Safari walk",
                "name": "Per day - per room",
                "attributes": []
            },
            {
                "id": 8001,
                "category": "Pets",
                "type": "Pets",
                "name": "Per day - per room",
                "attributes": [
                    {
                        "name": "NumPets",
                        "dataType": "int",
                        "description": "Specifies the number of allowed pets. Minimum: 1 Maximum: 5",
                        "required": true
                    }
                ]
            }
        ],
        "meal_plan_types": [
            {
                "0": {
                    "description": "None",
                    "mapping": "0"
                },
                "1": {
                    "description": "All inclusive",
                    "mapping": "1"
                },
                "19": {
                    "description": "Breakfast",
                    "mapping": "19"
                },
                "21": {
                    "description": "Lunch",
                    "mapping": "21"
                },
                "22": {
                    "description": "Dinner",
                    "mapping": "22"
                },
                "2": {
                    "description": "American",
                    "mapping": "19, 21, 22"
                },
                "3": {
                    "description": "Bed & breakfast",
                    "mapping": "19"
                },
                "4": {
                    "description": "Buffet breakfast",
                    "mapping": "19"
                },
                "5": {
                    "description": "Caribbean breakfast",
                    "mapping": "19"
                },
                "6": {
                    "description": "Continental breakfast",
                    "mapping": "19"
                },
                "7": {
                    "description": "English breakfast",
                    "mapping": "19"
                },
                "8": {
                    "description": "European plan",
                    "mapping": "0"
                },
                "9": {
                    "description": "Family plan",
                    "mapping": "0"
                },
                "10": {
                    "description": "Full board",
                    "mapping": "19, 21, 22"
                },
                "11": {
                    "description": "Full breakfast",
                    "mapping": "19"
                },
                "12": {
                    "description": "Half board/modified American plan",
                    "mapping": "19, 22"
                },
                "14": {
                    "description": "Room only",
                    "mapping": "0"
                },
                "15": {
                    "description": "Self catering",
                    "mapping": "0"
                },
                "16": {
                    "description": "Bermuda",
                    "mapping": "19"
                },
                "17": {
                    "description": "Dinner bed and breakfast plan",
                    "mapping": "19, 22"
                },
                "18": {
                    "description": "Family American",
                    "mapping": "0"
                },
                "20": {
                    "description": "Modified",
                    "mapping": "19, 22"
                },
                "23": {
                    "description": "Breakfast & lunch",
                    "mapping": "19, 21"
                },
                "24": {
                    "description": "Lunch & Dinner",
                    "mapping": "21, 22"
                }
            }
        ]
    },
    "Message": "Product Meta fetched successfully",
    "Ruid": ""
}

Success Response Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.


Messagestring

Message detailing the status or result of the request.


Ruid string

A unique identifier associated with the request.


Data object

Contains detailed information related to value adds and meal plan types.

value_adds array

An array containing the value add items for the hotel (for example, services, credits).

id integer

Unique identifier for the value add item.

categorystring

Category of the value add (for example, "Transportation", "Food and Beverage").

typestring

The type of the value add (for example, "Parking", "Credit or discount").

name string

Name of the value add (for example, "Self: 1 car Per room - per stay").


attributes array

An array of attribute objects, which can provide additional details like amount or currency.

namestring

Name of the attribute (for example, "CurrencyCode", "Amount").

dataTypestring

Data type of the attribute (for example, "string", "double", "int").

descriptionstring

Detailed description of what the attribute represents (for example, currency code, amount).

required boolean

Whether the attribute is required (true/false).


meal_plan_types array

Array containing different meal plan types and their mappings. The meal plan types in the provided code include various options for accommodation packages, each offering a combination of meals and services.

meal_plan_type object

Represents a meal plan type with description and mapping.

Here's the table summarizing the meal plan types, their mappings, and descriptions:

Meal Plan Code
Meal Plan Description
Mapping
Description

0

None

0

No meals are included in the plan.

1

All inclusive

1

This plan includes all meals, drinks, and sometimes additional services or amenities.

19

Breakfast

19

Only breakfast is included in the plan.

21

Lunch

21

Only lunch is included in the plan.

22

Dinner

22

Only dinner is included in the plan.

2

American

19, 21, 22

Includes all three main meals: breakfast, lunch, and dinner.

3

Bed & breakfast

19

This plan includes breakfast along with the accommodation, but no other meals.

4

Buffet breakfast

19

A buffet-style breakfast is included, typically with a variety of food choices.

5

Caribbean breakfast

19

A breakfast option featuring dishes typically found in the Caribbean.

6

Continental breakfast

19

A light breakfast, usually including bread, pastries, and beverages such as coffee and juice.

7

English breakfast

19

A hearty breakfast commonly consisting of eggs, sausages, bacon, beans, and other cooked items.

8

European plan

0

No meals are included in the accommodation rate, similar to the "None" plan.

9

Family plan

0

A plan where no meals are included, often designed for families, but specific details are not provided.

10

Full board

19, 21, 22

Includes breakfast, lunch, and dinner, similar to the "American" plan.

11

Full breakfast

19

A full breakfast is provided, typically offering a wider variety than a continental breakfast.

12

Half board/Modified American plan

19, 22

Includes breakfast and dinner, but lunch is not provided.

14

Room only

0

No meals are included, just accommodation.

15

Self catering

0

No meals are included, and guests are expected to prepare their own food.

16

Bermuda

19

This refers to a type of breakfast, typically in the style of those found in Bermuda.

17

Dinner bed and breakfast plan

19, 22

Includes both breakfast and dinner, but no lunch.

18

Family American

0

Similar to the "Family plan," it does not include meals.

20

Modified

19, 22

This plan includes breakfast and dinner, but lunch is not included, akin to the "Half board" plan.

23

Breakfast & lunch

19, 21

This plan includes breakfast and lunch but does not include dinner.

24

Lunch & Dinner

21, 22

Includes lunch and dinner but no breakfast.

This table lists each meal plan, its associated mapping(s), and provides a description of what each plan includes.

In the meal_plan_type object, the keys such as "0", "1", "19", etc., represent the specificmeal_plan_code. See the description of the parameters in the each meal_plan_type object below.

descriptionstring

Description of the meal plan type (for example, "None", "All inclusive").

mappingstring

Mapping of the meal plan type to a specific code or identifier.