Jet Cab AMS: Amsterdam & Schiphol chauffeur

Fixed-fare Schiphol transfers (route ids, per-car prices), private tours (tour ids, durations, per-car prices), vehicles with passenger and luggage limits, and booking rules. No side effects.

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

Exact price and rule check for one ride (no booking, no email, no payment). Returns the total, any online deposit and a quoteToken valid for 15 minutes. Per type: fixed needs routeId, direction and address; custom needs pickup and dropoff; tour needs tourIds and pickup. Fixed fares only apply inside each route's zone: error address_zone means quote a custom ride instead. Does not check driver availability.

{
  "type": "object",
  "properties": {
    "pickup": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations."
    },
    "dropoff": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Required for custom rides: drop-off address."
    },
    "tourIds": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "amsterdam-city-tour",
          "countryside-tour",
          "keukenhof-tour",
          "aalsmeer-flower-auction",
          "dutch-water-defence-line",
          "giethoorn-day-trip",
          "south-holland-tour",
          "rotterdam-kinderdijk",
          "kroller-muller",
          "efteling-day-trip",
          "bruges-day-trip",
          "roermond-outlet",
          "mall-of-the-netherlands",
          "batavia-stad",
          "style-outlet-amsterdam"
        ]
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Tours only; ids from /data/tours.json."
    },
    "type": {
      "type": "string",
      "enum": [
        "fixed",
        "custom",
        "tour"
      ]
    },
    "car": {
      "type": "string",
      "enum": [
        "eclass",
        "sclass",
        "vclass"
      ],
      "description": "E-Class max 4, S-Class max 2, V-Class max 7 passengers."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local date in Europe/Amsterdam."
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$",
      "description": "Local time in Europe/Amsterdam, between 04:00 and 20:00."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "luggageLarge": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Large check-in suitcases. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
    },
    "luggageSmall": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Pieces of hand luggage. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
    },
    "returnTrip": {
      "type": "object",
      "description": "Fixed rides only. Books the return leg as well: the opposite direction between the same address and Schiphol, with the same vehicle, passengers and luggage. It is priced as a second ride (plus the name-card fee when meetGreet is set on a return that starts at Schiphol). It must be at least one hour after the first ride, between 04:00 and 20:00, and not on a blocked date. Error codes: retour_type, retour, retour_datetime, retour_hours, retour_date_blocked, retour_order. The booking is stored as two linked bookings: the request id and `<id>-ret`.",
      "properties": {
        "date": {
          "type": "string",
          "format": "date"
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}$"
        },
        "flight": {
          "type": "string",
          "maxLength": 24
        },
        "meetGreet": {
          "type": "boolean",
          "default": false
        }
      },
      "required": [
        "date",
        "time"
      ]
    },
    "routeId": {
      "type": "string",
      "description": "Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to.",
      "enum": [
        "ams-spl",
        "noord-spl",
        "zaandam-spl",
        "aveen-spl",
        "haarlem-spl",
        "zandvoort-spl",
        "dh-spl",
        "rtm-spl",
        "almere-spl",
        "almere-buiten-spl",
        "utrecht-spl"
      ]
    },
    "direction": {
      "type": "string",
      "enum": [
        "to",
        "from"
      ],
      "description": "Fixed routes only: to or from Schiphol."
    },
    "address": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a custom ride."
    },
    "meetGreet": {
      "type": "boolean",
      "description": "Optional €25 arrivals-area name card; only for direction=from."
    },
    "ticketService": {
      "type": "boolean",
      "description": "Tours only: attraction ticket purchase assistance, requires 28 days' notice."
    },
    "driverName": {
      "type": "string",
      "maxLength": 60
    },
    "flight": {
      "type": "string",
      "maxLength": 24
    },
    "notes": {
      "type": "string",
      "maxLength": 1000
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "nl",
        "de",
        "fr",
        "es",
        "pt",
        "ru",
        "ar",
        "zh-CN"
      ]
    }
  },
  "required": [
    "type",
    "car",
    "date",
    "time",
    "passengers"
  ]
}

Books the quoted ride. Call ONLY after the customer has seen the quoted total and deposit and has explicitly approved it and accepted the Terms (https://www.jetcabams.nl/terms.html). Send exactly the same ride fields as the get_quote call plus its unchanged quoteToken and the customer's real contact details. Fixed rides: the customer first gets an email with a Confirm link (valid 24 hours); after the click the driver confirms by email, payment in the car. Tours and custom rides: returns checkoutUrl for the 25% Mollie prepayment, which the customer must open and pay. Repeating the identical call does not create a second booking.

{
  "type": "object",
  "properties": {
    "pickup": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations."
    },
    "dropoff": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Required for custom rides: drop-off address."
    },
    "tourIds": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "amsterdam-city-tour",
          "countryside-tour",
          "keukenhof-tour",
          "aalsmeer-flower-auction",
          "dutch-water-defence-line",
          "giethoorn-day-trip",
          "south-holland-tour",
          "rotterdam-kinderdijk",
          "kroller-muller",
          "efteling-day-trip",
          "bruges-day-trip",
          "roermond-outlet",
          "mall-of-the-netherlands",
          "batavia-stad",
          "style-outlet-amsterdam"
        ]
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Tours only; ids from /data/tours.json."
    },
    "type": {
      "type": "string",
      "enum": [
        "fixed",
        "custom",
        "tour"
      ]
    },
    "car": {
      "type": "string",
      "enum": [
        "eclass",
        "sclass",
        "vclass"
      ],
      "description": "E-Class max 4, S-Class max 2, V-Class max 7 passengers."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local date in Europe/Amsterdam."
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$",
      "description": "Local time in Europe/Amsterdam, between 04:00 and 20:00."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "luggageLarge": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Large check-in suitcases. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
    },
    "luggageSmall": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Pieces of hand luggage. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
    },
    "returnTrip": {
      "type": "object",
      "description": "Fixed rides only. Books the return leg as well: the opposite direction between the same address and Schiphol, with the same vehicle, passengers and luggage. It is priced as a second ride (plus the name-card fee when meetGreet is set on a return that starts at Schiphol). It must be at least one hour after the first ride, between 04:00 and 20:00, and not on a blocked date. Error codes: retour_type, retour, retour_datetime, retour_hours, retour_date_blocked, retour_order. The booking is stored as two linked bookings: the request id and `<id>-ret`.",
      "properties": {
        "date": {
          "type": "string",
          "format": "date"
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}$"
        },
        "flight": {
          "type": "string",
          "maxLength": 24
        },
        "meetGreet": {
          "type": "boolean",
          "default": false
        }
      },
      "required": [
        "date",
        "time"
      ]
    },
    "routeId": {
      "type": "string",
      "description": "Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to.",
      "enum": [
        "ams-spl",
        "noord-spl",
        "zaandam-spl",
        "aveen-spl",
        "haarlem-spl",
        "zandvoort-spl",
        "dh-spl",
        "rtm-spl",
        "almere-spl",
        "almere-buiten-spl",
        "utrecht-spl"
      ]
    },
    "direction": {
      "type": "string",
      "enum": [
        "to",
        "from"
      ],
      "description": "Fixed routes only: to or from Schiphol."
    },
    "address": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a custom ride."
    },
    "meetGreet": {
      "type": "boolean",
      "description": "Optional €25 arrivals-area name card; only for direction=from."
    },
    "ticketService": {
      "type": "boolean",
      "description": "Tours only: attraction ticket purchase assistance, requires 28 days' notice."
    },
    "driverName": {
      "type": "string",
      "maxLength": 60
    },
    "flight": {
      "type": "string",
      "maxLength": 24
    },
    "notes": {
      "type": "string",
      "maxLength": 1000
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "nl",
        "de",
        "fr",
        "es",
        "pt",
        "ru",
        "ar",
        "zh-CN"
      ]
    },
    "quoteToken": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and deposit. It binds the normalized journey, vehicle, passengers, options, fare, rules version and 15-minute expiry. HTTP 409 reviewRequired=true means obtain a new quote and renewed customer approval before retrying. Never supply your own price."
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "phone": {
      "type": "string",
      "minLength": 7,
      "maxLength": 30,
      "description": "Customer's phone number, with country code (for example +31 6 1234 5678)."
    },
    "acceptedTerms": {
      "type": "boolean",
      "const": true,
      "description": "Must be an explicit act by the customer after reading the Terms & Conditions. Agents must not set this on a customer's behalf without their consent."
    },
    "additionalRides": {
      "type": "array",
      "maxItems": 4,
      "description": "Optional: more rides in the same request (up to 5 in total), each with its own ride fields and the quoteToken of its own get_quote call. Tours and custom rides in the request share one 25% prepayment link; fixed rides stay pay-in-car requests.",
      "items": {
        "type": "object",
        "properties": {
          "pickup": {
            "type": "string",
            "minLength": 4,
            "maxLength": 180,
            "description": "Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations."
          },
          "dropoff": {
            "type": "string",
            "minLength": 4,
            "maxLength": 180,
            "description": "Required for custom rides: drop-off address."
          },
          "tourIds": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "amsterdam-city-tour",
                "countryside-tour",
                "keukenhof-tour",
                "aalsmeer-flower-auction",
                "dutch-water-defence-line",
                "giethoorn-day-trip",
                "south-holland-tour",
                "rotterdam-kinderdijk",
                "kroller-muller",
                "efteling-day-trip",
                "bruges-day-trip",
                "roermond-outlet",
                "mall-of-the-netherlands",
                "batavia-stad",
                "style-outlet-amsterdam"
              ]
            },
            "minItems": 1,
            "maxItems": 5,
            "description": "Tours only; ids from /data/tours.json."
          },
          "type": {
            "type": "string",
            "enum": [
              "fixed",
              "custom",
              "tour"
            ]
          },
          "car": {
            "type": "string",
            "enum": [
              "eclass",
              "sclass",
              "vclass"
            ],
            "description": "E-Class max 4, S-Class max 2, V-Class max 7 passengers."
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Local date in Europe/Amsterdam."
          },
          "time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$",
            "description": "Local time in Europe/Amsterdam, between 04:00 and 20:00."
          },
          "passengers": {
            "type": "integer",
            "minimum": 1,
            "maximum": 7
          },
          "luggageLarge": {
            "type": "integer",
            "minimum": 0,
            "maximum": 8,
            "default": 0,
            "description": "Large check-in suitcases. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
          },
          "luggageSmall": {
            "type": "integer",
            "minimum": 0,
            "maximum": 8,
            "default": 0,
            "description": "Pieces of hand luggage. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
          },
          "returnTrip": {
            "type": "object",
            "description": "Fixed rides only. Books the return leg as well: the opposite direction between the same address and Schiphol, with the same vehicle, passengers and luggage. It is priced as a second ride (plus the name-card fee when meetGreet is set on a return that starts at Schiphol). It must be at least one hour after the first ride, between 04:00 and 20:00, and not on a blocked date. Error codes: retour_type, retour, retour_datetime, retour_hours, retour_date_blocked, retour_order. The booking is stored as two linked bookings: the request id and `<id>-ret`.",
            "properties": {
              "date": {
                "type": "string",
                "format": "date"
              },
              "time": {
                "type": "string",
                "pattern": "^\\d{2}:\\d{2}$"
              },
              "flight": {
                "type": "string",
                "maxLength": 24
              },
              "meetGreet": {
                "type": "boolean",
                "default": false
              }
            },
            "required": [
              "date",
              "time"
            ]
          },
          "routeId": {
            "type": "string",
            "description": "Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to.",
            "enum": [
              "ams-spl",
              "noord-spl",
              "zaandam-spl",
              "aveen-spl",
              "haarlem-spl",
              "zandvoort-spl",
              "dh-spl",
              "rtm-spl",
              "almere-spl",
              "almere-buiten-spl",
              "utrecht-spl"
            ]
          },
          "direction": {
            "type": "string",
            "enum": [
              "to",
              "from"
            ],
            "description": "Fixed routes only: to or from Schiphol."
          },
          "address": {
            "type": "string",
            "minLength": 4,
            "maxLength": 180,
            "description": "Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a custom ride."
          },
          "meetGreet": {
            "type": "boolean",
            "description": "Optional €25 arrivals-area name card; only for direction=from."
          },
          "ticketService": {
            "type": "boolean",
            "description": "Tours only: attraction ticket purchase assistance, requires 28 days' notice."
          },
          "driverName": {
            "type": "string",
            "maxLength": 60
          },
          "flight": {
            "type": "string",
            "maxLength": 24
          },
          "notes": {
            "type": "string",
            "maxLength": 1000
          },
          "lang": {
            "type": "string",
            "enum": [
              "en",
              "nl",
              "de",
              "fr",
              "es",
              "pt",
              "ru",
              "ar",
              "zh-CN"
            ]
          },
          "quoteToken": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "description": "Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and deposit. It binds the normalized journey, vehicle, passengers, options, fare, rules version and 15-minute expiry. HTTP 409 reviewRequired=true means obtain a new quote and renewed customer approval before retrying. Never supply your own price."
          }
        },
        "required": [
          "type",
          "car",
          "date",
          "time",
          "passengers",
          "quoteToken"
        ]
      }
    }
  },
  "required": [
    "type",
    "car",
    "date",
    "time",
    "passengers",
    "quoteToken",
    "name",
    "email",
    "phone",
    "acceptedTerms"
  ]
}

Where a booking request stands: waiting for the customer's email confirmation, waiting for the driver, payment pending (with the payment link), confirmed, completed or cancelled. Needs the bookingId from request_booking and the customer's email.

{
  "type": "object",
  "properties": {
    "bookingId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,80}$",
      "description": "The bookingId returned by request_booking."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "The customer's email address used for the booking (proves it is their booking)."
    }
  },
  "required": [
    "bookingId",
    "email"
  ]
}

Changes an existing booking at the customer's request (date, time, address, pickup, drop-off, passengers, luggage, car, flight, notes). First call get_quote with the complete changed ride and get the customer's approval of the new price, then send the same ride fields with that quoteToken plus the bookingId and the customer's email. Requests not yet confirmed by the driver are updated at once (a request still waiting for the email confirmation is re-sent with a new link; an unpaid tour gets a new payment link). Confirmed or paid bookings are passed to Jet Cab AMS as a change request, which they confirm by email. The ride type (transfer, custom ride, tour) cannot change: cancel and book anew instead.

{
  "type": "object",
  "properties": {
    "bookingId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,80}$",
      "description": "The bookingId returned by request_booking."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "The customer's email address used for the booking (proves it is their booking)."
    },
    "pickup": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations."
    },
    "dropoff": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Required for custom rides: drop-off address."
    },
    "tourIds": {
      "type": "array",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "amsterdam-city-tour",
          "countryside-tour",
          "keukenhof-tour",
          "aalsmeer-flower-auction",
          "dutch-water-defence-line",
          "giethoorn-day-trip",
          "south-holland-tour",
          "rotterdam-kinderdijk",
          "kroller-muller",
          "efteling-day-trip",
          "bruges-day-trip",
          "roermond-outlet",
          "mall-of-the-netherlands",
          "batavia-stad",
          "style-outlet-amsterdam"
        ]
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Tours only; ids from /data/tours.json."
    },
    "type": {
      "type": "string",
      "enum": [
        "fixed",
        "custom",
        "tour"
      ]
    },
    "car": {
      "type": "string",
      "enum": [
        "eclass",
        "sclass",
        "vclass"
      ],
      "description": "E-Class max 4, S-Class max 2, V-Class max 7 passengers."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local date in Europe/Amsterdam."
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$",
      "description": "Local time in Europe/Amsterdam, between 04:00 and 20:00."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "luggageLarge": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Large check-in suitcases. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
    },
    "luggageSmall": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Pieces of hand luggage. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
    },
    "returnTrip": {
      "type": "object",
      "description": "Fixed rides only. Books the return leg as well: the opposite direction between the same address and Schiphol, with the same vehicle, passengers and luggage. It is priced as a second ride (plus the name-card fee when meetGreet is set on a return that starts at Schiphol). It must be at least one hour after the first ride, between 04:00 and 20:00, and not on a blocked date. Error codes: retour_type, retour, retour_datetime, retour_hours, retour_date_blocked, retour_order. The booking is stored as two linked bookings: the request id and `<id>-ret`.",
      "properties": {
        "date": {
          "type": "string",
          "format": "date"
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{2}:\\d{2}$"
        },
        "flight": {
          "type": "string",
          "maxLength": 24
        },
        "meetGreet": {
          "type": "boolean",
          "default": false
        }
      },
      "required": [
        "date",
        "time"
      ]
    },
    "routeId": {
      "type": "string",
      "description": "Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to.",
      "enum": [
        "ams-spl",
        "noord-spl",
        "zaandam-spl",
        "aveen-spl",
        "haarlem-spl",
        "zandvoort-spl",
        "dh-spl",
        "rtm-spl",
        "almere-spl",
        "almere-buiten-spl",
        "utrecht-spl"
      ]
    },
    "direction": {
      "type": "string",
      "enum": [
        "to",
        "from"
      ],
      "description": "Fixed routes only: to or from Schiphol."
    },
    "address": {
      "type": "string",
      "minLength": 4,
      "maxLength": 180,
      "description": "Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a custom ride."
    },
    "meetGreet": {
      "type": "boolean",
      "description": "Optional €25 arrivals-area name card; only for direction=from."
    },
    "ticketService": {
      "type": "boolean",
      "description": "Tours only: attraction ticket purchase assistance, requires 28 days' notice."
    },
    "driverName": {
      "type": "string",
      "maxLength": 60
    },
    "flight": {
      "type": "string",
      "maxLength": 24
    },
    "notes": {
      "type": "string",
      "maxLength": 1000
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "nl",
        "de",
        "fr",
        "es",
        "pt",
        "ru",
        "ar",
        "zh-CN"
      ]
    },
    "quoteToken": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and deposit. It binds the normalized journey, vehicle, passengers, options, fare, rules version and 15-minute expiry. HTTP 409 reviewRequired=true means obtain a new quote and renewed customer approval before retrying. Never supply your own price."
    }
  },
  "required": [
    "bookingId",
    "email",
    "quoteToken",
    "type",
    "car",
    "date",
    "time",
    "passengers"
  ]
}

Cancels a booking at the customer's explicit request. Requests not yet confirmed by the driver and unpaid tours are cancelled at once (the customer gets an email). Confirmed or paid bookings are passed to the business as a cancellation request, which it handles under the Terms (free until 24 hours before transfers, 48 hours before tours). Needs the bookingId and the customer's email. Ask the customer to confirm before calling.

{
  "type": "object",
  "properties": {
    "bookingId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,80}$",
      "description": "The bookingId returned by request_booking."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "The customer's email address used for the booking (proves it is their booking)."
    },
    "reason": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional reason from the customer."
    }
  },
  "required": [
    "bookingId",
    "email"
  ]
}