MAPL Tours Jamaica

Find hotels and villas MAPL Tours drives to from Sangster International Airport (MBJ), Montego Bay, Jamaica. Returns up to 8 matches with the id to use in get_transfer_quote, or the "Other hotel or villa" id for each area when nothing matches. Covers 199 properties from Montego Bay to Negril, Ocho Rios, Falmouth and Lucea. Kingston, Port Antonio and Mandeville are quoted by email instead.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Hotel, villa, resort or town name, e.g. \"Sandals Negril\" or \"Ocho Rios\""
    }
  },
  "required": [
    "query"
  ]
}

Exact all-in price in USD for a private airport transfer between Sangster International Airport (MBJ) and a hotel or villa, per vehicle for up to 4 passengers (5 to 7 priced per person; 8 or more are quoted by email at [email protected]). Round trip or one way, either direction. Also says how long before the flight home the hotel pickup should be. Use before start_transfer_booking. Read-only.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Hotel or villa name, or an id from find_transfer_destination"
    },
    "trip_type": {
      "type": "string",
      "enum": [
        "round_trip",
        "one_way"
      ],
      "description": "Default round_trip (airport to hotel and back)"
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "Number of passengers, 1 to 7. Default 2"
    },
    "direction": {
      "type": "string",
      "enum": [
        "airport_to_hotel",
        "hotel_to_airport"
      ],
      "description": "One-way only. Default airport_to_hotel"
    }
  },
  "required": [
    "destination"
  ]
}

Check whether a pickup can be booked online. Bookings need 24 hours' notice in Jamaica time. Give arrival_at (flight lands at MBJ) and, for the flight home, departure_at (hotel pickup) or departure_flight_at (flight departs; the pickup is worked out from it), each as "YYYY-MM-DDTHH:MM" Jamaica local time with no timezone suffix. Returns whether each leg is bookable and the earliest bookable time. Read-only.

{
  "type": "object",
  "properties": {
    "arrival_at": {
      "type": "string",
      "description": "Flight arrival at MBJ, \"YYYY-MM-DDTHH:MM\" Jamaica time"
    },
    "departure_at": {
      "type": "string",
      "description": "Hotel pickup for the flight home, \"YYYY-MM-DDTHH:MM\" Jamaica time"
    },
    "departure_flight_at": {
      "type": "string",
      "description": "Flight home departs MBJ, \"YYYY-MM-DDTHH:MM\" Jamaica time; the hotel pickup is 3 hours 30 minutes earlier"
    }
  }
}

Make a mapltours.com booking link for an airport transfer. The traveller opens it and lands on checkout with the hotel, trip type, passengers, flights and times filled in; they add name, email and phone and pay there (card, Apple Pay, Google Pay or Link). Books and charges nothing by itself. A one-way needs direction: airport_to_hotel takes arrival_at and arrival_flight; hotel_to_airport takes departure_at (or departure_flight_at) and departure_flight. Confirm the details and the price from get_transfer_quote with the traveller first.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Hotel or villa name, or id from find_transfer_destination"
    },
    "trip_type": {
      "type": "string",
      "enum": [
        "round_trip",
        "one_way"
      ]
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "direction": {
      "type": "string",
      "enum": [
        "airport_to_hotel",
        "hotel_to_airport"
      ],
      "description": "Required for a one-way"
    },
    "arrival_at": {
      "type": "string",
      "description": "Flight arrival at MBJ, \"YYYY-MM-DDTHH:MM\" Jamaica time"
    },
    "arrival_flight": {
      "type": "string",
      "description": "Arrival flight number, e.g. AA1234"
    },
    "departure_at": {
      "type": "string",
      "description": "Hotel pickup for the flight home, \"YYYY-MM-DDTHH:MM\" Jamaica time. If you only know the flight time, pass departure_flight_at instead"
    },
    "departure_flight_at": {
      "type": "string",
      "description": "Flight home departs MBJ, \"YYYY-MM-DDTHH:MM\" Jamaica time; pickup is set 3 hours 30 minutes earlier"
    },
    "departure_flight": {
      "type": "string",
      "description": "Departure flight number"
    }
  },
  "required": [
    "destination",
    "trip_type",
    "passengers"
  ]
}

List the 20 private tours and day packages MAPL Tours runs in Jamaica (Dunn's River, Blue Hole, bamboo rafting, Rick's Cafe, zipline, ATV, horseback and more). fromPriceUsd is the price for the smallest party; priceUnit says whether it covers a party of up to N people or one person. Use get_tour with guests for the exact total. Hotel pickup included. Optional keyword or area filter; returns up to 12 rows. Read-only.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword, e.g. \"waterfall\", \"rafting\", \"sunset\""
    },
    "area": {
      "type": "string",
      "description": "Town or area, e.g. \"Ocho Rios\", \"Negril\", \"Montego Bay\""
    }
  }
}

Details for one tour: what it includes, ages, fitness, what to bring, the exact total for a party size, and the earliest bookable date. Read-only.

{
  "type": "object",
  "properties": {
    "tour": {
      "type": "string",
      "description": "Tour title or slug from list_tours"
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Party size to price, default 2"
    }
  },
  "required": [
    "tour"
  ]
}

Make a mapltours.com booking link for a tour or day package on a date for a party size. The traveller opens it and lands on checkout with the tour, date and guests filled in; they add contact details, accept the activity waiver and pay there. Books and charges nothing by itself. Needs 24 hours' notice; get_tour gives the earliest date and the exact price. Confirm tour, date, guests and price with the traveller first.

{
  "type": "object",
  "properties": {
    "tour": {
      "type": "string",
      "description": "Tour title or slug from list_tours"
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "date": {
      "type": "string",
      "description": "Tour date \"YYYY-MM-DD\" (Jamaica); needs 24 hours' notice, get_tour gives the earliest date"
    },
    "pickup_hotel": {
      "type": "string",
      "description": "Where the traveller is staying, for the hotel pickup"
    }
  },
  "required": [
    "tour",
    "guests",
    "date"
  ]
}

What a MAPL Tours Jamaica booking includes and the rules that apply: all-in pricing, notice needed, flight tracking, cancellation and refunds, payment methods and contact. Tell the traveller the cancellation terms before they book. Read-only.

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