Questions parameter validation - getyourguide/partner-api-spec GitHub Wiki

Questions parameter validations

In the questions parameter, the partner must provide the questions the user needs to answer during the booking process. The questions are divided into two categories: Participant Questions and Booking Questions.

Participant Questions

Each participant (e.g., an adult) must provide answers to the following questions during the booking process.

Question Validation Expected Description
traveler_dietary_restrictions value: String max length: 500 Please provide info about any dietary restrictions
traveler_diving_level value: String max length: 500 Please provide the wetsuit size, diving level, certification number, number of dives completed, and date of last dive, for everyone in your group
traveler_driver_license value: String max length: 500 Please provide the driver’s license details of all drivers
traveler_skill_level value: String max length: 500 Please provide the skill level (beginner, intermediate, or advanced) of everyone in your group.
traveler_id_details value: String max length: 500 Please provide the ID or passport details (country, number, date of issuance, expiration) of the traveler.
traveler_passport_details value: String max length: 500 Please provide the passport details (country, number, date of issuance, expiration) of the traveler.
traveler_id_number value: String max length: 45 Please provide the ID or passport numbers of the traveler.
traveler_passport_number value: String max length: 18 Please provide the passport numbers of the traveler.
traveler_age value: String max length: 3 Please provide the age of the traveler.
traveler_children_age value: String max length: 3 Please provide the ages of all children in your group (if any).
traveler_name first_name: String max length: 45 with Latin characters (letters), last_name: String max length: 45 with Latin characters (letters) Please provide the full name of the traveler.
traveler_date_of_birth value: String Format: “Y-m-d” Please provide the date of birth.
traveler_weight amount: String max length: 5, unit: Enum values: "kg", "lb" Please provide the weight of the traveler.
traveler_shoe_size amount: String max length: 5, unit: Enum values: "cm", "uk", "us", "eu" Please provide the shoe size of everyone in your group
traveler_height amount: String max length: 5, unit: Enum values: "cm", "m", "ft" Please provide the height of the traveler.

Booking Questions

This question must be answered once per booking.

Question Validation Expected Description
booking_child_safety_seat value: String max length: 500 Please provide the number of child safety seats needed
booking_cruise_details value: String max length: 500 Please provide your ship name and details about your arrival and departure
booking_drop_off_address value: String max length: 500 Please provide the address where you want to be dropped off
booking_medical_conditions value: String max length: 500 Please provide info about any medical conditions.
booking_mobility_issues value: String max length: 500 Please provide any mobility requirements.
booking_shipping_address value: String max length: 500 Please provide a mailing address.
booking_wheelchair value: String max length: 500 Please provide any wheelchair access requirements.
booking_pick_up_location full_address: String max length: 500, coordinates: mandatory latitude and longitude valid values Address to be picked up from tour option pick_up_location field.
booking_flight_details flight_number: String max length: 10, time_of_arrival: String max length: 10 Please provide your group's flight details