Overview

The Merchandising API Meal Plans service allows travel buyers to retrieve the complete list of supported meal plan codes and descriptions.

The response returns all supported meal plan codes available within the Hotel Trader ecosystem.

Endpoint

https://sandbox-api-mtd.hoteltrader.com/distribution/graphql

Authentication

The Merchandising API uses HTTP Basic Authentication.

Authorization: Basic base64(username:password)

Get Meal Plans

Example Request

curl --location 'https://sandbox-api-mtd.hoteltrader.com/distribution/graphql' \
--header 'Authorization: Basic <BASE64_CREDENTIALS>' \
--header 'Content-Type: application/json' \
--data '{
  "query":"query {
    GetMealPlans {
      mealPlans {
        mealPlanCode
        mealPlanName
      }
    }
  }",
  "variables":{}
}'

Response Structure

{
  "data": {
    "GetMealPlans": {
      "mealPlans": []
    }
  }
}

Meal Plan Object

Field	Type	Description
mealPlanCode	String	Standardized meal plan code.
mealPlanName	String	Human-readable meal plan description.

Example Meal Plan Response

{
  "mealPlanCode":"RO",
  "mealPlanName":"Room Only"
}

{
  "mealPlanCode":"BBI",
  "mealPlanName":"Breakfast Included"
}

{
  "mealPlanCode":"AII",
  "mealPlanName":"All Inclusive Included"
}

Common Meal Plan Categories

(This is not a comprehensive list)

Category	Example Codes
Room Only	`RO`
Continental Breakfast	`CBF`, `CBI`, `C2I`
Breakfast Included	`BBF`, `BBI`, `B2I`
Buffet Breakfast	`UFF`, `UFI`, `U2I`
Half Board	`HBFL`, `HBFD`, `HBIL`, `HBID`
Full Board	`FBF`, `FBI`
All Inclusive	`AIF`, `AII`

Common Integration Flow

Meal Plan Mapping

Retrieve the full meal plan list.
Store meal plan codes internally.
Use standardized meal plan codes across rate ingestion and display systems.

MealPlans