Last updated 6 minutes ago

Consolidated Routehappy Endpoint

The Consolidated Routehappy endpoint provides access to all Routehappy Content types - Amenities, UPAs, and UTAs - from a single request, with a new schema and new functionality compared with the previous Routehappy Rich Content APIs.

Request parameters

The top-level parameters in a request to the Consolidated Routehappy endpoint are acct_code, control, currency, data, and pcc. Much of the definition of your request will fall within the control and data parameters.

Field Name Description Type Values
acct_code (optional) Needed for corporate fares String
control (optional) Wrapper for the specifications of the types of Routehappy Content to be included in the response Object
currency (optional) The currency the ticket was purchased in String currency codes
data Wrapper for the specifications of the requested tickets/reservations Object
pcc (optional) PCC code, Office ID or Travel Agency ID, IATA code. This code is used in ATPCO fare filings to determine if the sales channel has access to this data String

Control parameters

Control parameters are all specified within a control object in the request body and describe the specifications of the types of Routehappy Content to be included in the response.

{
	"control" : {
		// control parameters go here
	},
	// ...
}
Field Name Description Type Values
includes (optional) Specifies which Routehappy Content types to include in the response Array amenity, upa, uta
include_rq (optional) Use if you would like to include the segment/flight information in the response. This is important if you want to map back to flight segments but the request data is not available. Boolean true, false

Amenities control

Field Name Description Type Values
amenity_categories_filter (optional) Specifies which amenities categories and summaries should be in the response Array aircraft, beverage, entertainment, fresh_food, layout, power, seat, wifi, aircraft_summary, entertainment_summary, fresh_food_summary, layout_summary, power_summary, seat_summary, wifi_summary

UPAs control

Field Name Description Type Values
upa_categories_filter (optional) Specifies which UPA categories should be in the response Array seat, wi-fi, meals, lounge, and others (more information coming soon)
disable_upa_photo (optional) Specifies whether photos should be ommitted from the response Boolean true, false
disable_upa_tour (optional) Specifies whether tours should be ommitted from the response Boolean true, false
disable_upa_video (optional) Specifies whether videos should be ommitted from the response Boolean true, false

UTAs control

Field Name Description Type Values
ticket_attributes_filter (optional) Specifies which UTA categories should be in the response Array advance_change, boarding_priority, brand, cancellation, carry_on_baggage, checked_baggage, check_in_priority, lounge_access, same_day_change, seat_selection, upgrade_eligibility
os_override (optional) Specifies which types of data the Routehappy API should process using data from branded fares instead of baggage engine Array advance_change, cancellation, carry_on_baggage, checked_baggage

Data parameters

Data parameters are all specified within a data object in the request body and describe the specifications of the requested tickets/reservations.

{
	// ...
	"data" : {
		// control parameters go here
	},
	// ...
}
Field Name Description Type Values
tkt_date (optional) Ticketing date Date-formatted string YYYY-MM-DD
res_date (optional) Date that the reservation was made Date-formatted string YYYY-MM-DD
itineraries List of itineraries (objects) in the request Array

Itinerary parameters

Itinerary parameters reside within the itineraries array and describe the specification of single itinerary.

Field Name Description Type Values
pos (optional) Point of sale of the ticket. Can be a city, country, or airport (2-3 letter code) String IATA codes
psgrs (optional*) List containing a single passenger type (string). Include one type of passenger on the ticket and the passenger type will be mapped to data.

* psgrs defaults to ADT if not included when when requesting UPAs or UTAs
Array ADT, CNN, and others
src (optional*) Where the pricing/fare came from String
segments List of flight segments (objects) Array

Segment parameters

Segment parameters reside within the segments array and describe the specification of a single segment.

Field Name Description Type Values
arr Arrival airport for the itinerary segment String IATA codes
cabin Cabin of the fare where 1=economy, 2=premium economy, 3=business, 4=first integer 1-4
cxr Carrier for the itinerary segment String IATA codes
date Departure date for the itinerary segment Date-formatted string YYYY-MM-DD
dep Departure airport for the itinerary segment String IATA codes
fbc (optional) Fare basis code. This field is required when fare-related/brand information is requested (e.g., UPAs or UTAs) String
fltno Flight number for the itinerary segment integer 1-9999
rbd (optional) Reservation booking designator for the itinerary segment upper-case character A-Z