Thomas Cook holidays

Searches holiday packages (flight + hotel) to one destination country. Returns packages with hotel name, stars, guest rating, board, departure date and airports, total and per-person price, and a link to book on the brand's website. Filters: dates, nights, travellers, departure airport, price, stars, board and region (regionCode from get_regions of the same country, countryCode from get_countries); sorting by popularity, price, rating or stars; cursor pagination. Only countryCode is required (defaults: departures in the next 2 months, 7 nights, 2 adults). Read-only.

{
  "type": "object",
  "properties": {
    "countryCode": {
      "description": "Two-letter destination country code (e.g. 'ES' for Spain, 'GR' for Greece, 'TR' for Turkey, 'EG' for Egypt), as listed by get_countries.",
      "type": "string"
    },
    "regionCode": {
      "description": "Optional region or city code from get_regions for the same countryCode (e.g. 're-ACA'); a code of another country is rejected. Narrows the search.",
      "type": "string",
      "default": null
    },
    "dateFrom": {
      "description": "Earliest departure, YYYY-MM-DD (optional, defaults to tomorrow). With dateTo, the window the whole trip must fit in.",
      "type": "string",
      "default": ""
    },
    "dateTo": {
      "description": "Latest return date, YYYY-MM-DD (optional, defaults to 2 months from now). At least the minimum nights after dateFrom; a shorter window is rejected.",
      "type": "string",
      "default": ""
    },
    "nights": {
      "description": "Number of nights (default: 7)",
      "type": "integer",
      "default": 7
    },
    "nightsMin": {
      "description": "Minimum number of nights of a flexible range (optional, together with nightsMax). When set, 'nights' is ignored.",
      "type": [
        "integer",
        "null"
      ],
      "default": null
    },
    "nightsMax": {
      "description": "Maximum number of nights of a flexible range (optional, together with nightsMin). When set, 'nights' is ignored.",
      "type": [
        "integer",
        "null"
      ],
      "default": null
    },
    "adults": {
      "description": "Number of adults (default: 2)",
      "type": "integer",
      "default": 2
    },
    "childrenAges": {
      "description": "Ages of children (optional, empty array if no children)",
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null
    },
    "departureAirport": {
      "description": "Departure airport IATA code (e.g. 'WAW' or 'KTW' on eSky, 'MAN' or 'LGW' on Thomas Cook UK). Omitted = all available departure airports.",
      "type": "string",
      "default": null
    },
    "minPrice": {
      "description": "Minimum price in the local currency (optional)",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "maxPrice": {
      "description": "Maximum price in the local currency (optional)",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "minStars": {
      "description": "Minimum hotel star rating 1-5 (optional)",
      "type": [
        "integer",
        "null"
      ],
      "default": null
    },
    "maxStars": {
      "description": "Maximum hotel star rating 1-5 (optional)",
      "type": [
        "integer",
        "null"
      ],
      "default": null
    },
    "mealType": {
      "description": "Meal plan filter: 'breakfast' (BB), 'half-board' (HB), 'full-board' (FB), 'all-inclusive' (AI), or 'room-only' (RO)",
      "type": "string",
      "default": null,
      "enum": [
        "breakfast",
        "half-board",
        "full-board",
        "all-inclusive",
        "room-only"
      ]
    },
    "sortBy": {
      "description": "Sort results by: 'popularity' (default, most booked first), 'price', 'rating', or 'stars'.",
      "type": "string",
      "default": null,
      "enum": [
        "popularity",
        "price",
        "rating",
        "stars"
      ]
    },
    "sortOrder": {
      "description": "Sort order: 'asc' (ascending) or 'desc' (descending). Default depends on sort type.",
      "type": "string",
      "default": null,
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Number of results to return (default 6, max 30)",
      "type": [
        "integer",
        "null"
      ],
      "default": null
    },
    "cursor": {
      "description": "Cursor for pagination (from previous response's nextCursor)",
      "type": "string",
      "default": null
    }
  },
  "required": [
    "countryCode"
  ]
}

Suggests holiday destinations for a natural-language request (e.g. 'warm beach in November with small children'). Returns destination ideas with an indicative package price per person, the reason each one matches, and the countryCode that search_packages accepts. Suited to requests without a chosen destination country. Read-only.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "What the user is looking for, in one or two short sentences, including the constraints that apply to this search (e.g. 'sunny beach holiday in June from Warsaw, 2 adults and a 5-year-old, under 6000 PLN').",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Lists the regions and cities of one destination country, with names and codes; a code narrows search_packages through its regionCode parameter. Read-only.

{
  "type": "object",
  "properties": {
    "countryCode": {
      "description": "Two-letter destination country code (e.g. 'ES' for Spain, 'GR' for Greece), as listed by get_countries.",
      "type": "string"
    }
  },
  "required": [
    "countryCode"
  ]
}

Lists the destination countries available for holiday package search, with names and the two-letter country codes used by search_packages. Read-only.

{
  "type": "object",
  "properties": {}
}