Booking Schemas¶
Data models for transportation booking operations.
Enums¶
RateType- P2P: 0, HOURLY: 1, DAILY: 2, TOUR: 3, ROUND_TRIP: 4, RT_HALF: 5LocationType- ADDRESS: 0, AIRPORT: 1, TRAIN_STATION: 2, CRUISE: 3ReservationStatus- ACTIVE: None, NO_SHOW: 0, CANCELED: 1, LATE_CANCELED: 2CardHolderType- CORPORATE: 0, AGENCY: 1, THIRD_PARTY: 2, SAME_AS_PASSENGER: 3MeetGreetType- Meet & greet options for airport pickupsRewardType- Reward program types (e.g., UNITED_MILEAGEPLUS: 0)
Location Models¶
City¶
Geographic location with country/state validation. Requires city_name and country_code (ISO 3166-1 alpha-2).
Address¶
Street address or venue location. Either google_geocode (preferred) or city required. Supports venue names via place_name.
Airport¶
Airport with IATA code and optional flight details. Requires valid 3-letter iata_code with optional terminal and flight info.
Location¶
Union of address or airport locations. Use type field to specify LocationType.ADDRESS or LocationType.AIRPORT.
Booking Data Models¶
Passenger¶
Passenger information with first_name, last_name, optional email, and phone (E164 format recommended).
CreditCard¶
Payment information with number, expiration (MM/YY), cvv, card_holder, optional zip and holder_type.
Stop¶
Additional stop with description (address/place name) and is_en_route boolean flag.
Account¶
Travel agency or corporate account info with id and optional booker details.
Request/Response Models¶
PriceRequest/PriceResponse- pricing operationsDetailsRequest/DetailsResponse- detail updatesBookRequest/BookResponse- reservation bookingListReservationsRequest/ListReservationsResponse- reservation listingGetReservationRequest/GetReservationResponse- reservation detailsEditReservationRequest/EditReservationResponse- modifications