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 |