Amenities Backwards Compatible

The Amenities Backwards Compatible endpoints are intended for users of the legacy Routehappy Scores and Amenities (S&A) API who are not yet prepared to migrate to the upcoming Routehappy API endpoint.

The Amenities Backwards Compatible endpoints provide access to key aspects of the onboard flight experience. These endpoints provides access to content that enables you to offer consumers targeted information when they are shopping for flights. Amenities data is matched to the global flight schedule, covering virtually every flight by cabin for approximately 300 airlines and nearly 100% of all flights worldwide and are translated into more than 25 languages.

The Amenities Backwards Compatible endpoints of the Routehappy API maintain the functionality of the legacy S&A API while improving response speed. Users of the legacy S&A API will be able to use the same request structure and can expect the same response structure from this newer, faster API.

In most cases, we strongly recommend partners use the data returned in the display_text attribute to display on their channels.

Schema
Schema

The table below contains the URLs for the Gold and Production environments of the Backwards Compatible endpoint's and schemas, respectively.

API Endpoint Schema UPA DS* UTA DS* Amenities DS*
https://gold.retailing.apis.atpco.net/routehappy/amenities Gold Schema N/A N/A Amenities Prod
https://retailing.apis.atpco.net/routehappy/amenities Production Schema N/A N/A Amenities Prod
https://gold.retailing.apis.atpco.net/routehappy/itineraries Gold Schema N/A N/A Amenities Prod
https://retailing.apis.atpco.net/routehappy/itineraries Production Schema N/A N/A Amenities Prod
https://gold.retailing.apis.atpco.net/routehappy/segments Gold Schema N/A N/A Amenities Prod
https://retailing.apis.atpco.net/routehappy/segments Production Schema N/A N/A Amenities Prod
https://gold.retailing.apis.atpco.net/routehappy/hub Gold Schema Hub Prod ATPCO Subs Prod N/A
https://retailing.apis.atpco.net/routehappy/hub Production Schema Hub Prod ATPCO Subs Prod N/A

* DS - Data Source within ATPCO from which the system is processing the data it displays.

Endpoints

Just like the legacy S&A API, the Routehappy API includes each of the following Amenities endpoints. The documentation for the Amenities Backwards Compatible endpoints is currently written relative to the /legs endpoint. If you are using the other endpoints today, your existing query will work with the new API. We will add documentation for the other endpoints soon. If you need help with the /segments, /itineraries, or categories endpoints in the meantime, please contact your account manager with questions.

  • GET/POST /legs
  • GET/POST /segments
  • GET/POST /itineraries
  • GET /aircrafts
  • GET /beverages
  • GET /entertainments
  • GET /fresh_foods
  • GET /layouts
  • GET /powers
  • GET /seats
  • GET /wifis
Important Note

The Amenity, Score, and Speed resources have been deprecated in the Amenities Backwards Compatible offering and are not valid inputs.

Standard Categories

The Amenities endpoints can return information about:

  • Aircraft : model type, window size and expected cabin pressure
  • Layout : configuration layout and orientation of seats covering everything from classic layouts to the newest space-saving premium-cabin configurations
  • Seat : the physical seat type for every subfleet in every cabin of the aircraft and the corresponding legroom, pitch, width, and flatness
  • Wi-Fi : wireless internet connection availability, coverage, type, performance and cost (free or for a fee)
  • Entertainment : covers passenger entertainment options and any corresponding charges
  • Power : covers whether AC power outlets, and/or USB ports are available
  • Food : covers food per flight and flight cabin and whether it’s available, for a fee or free. Food is classified as snacks, light meals, and full multi-course meals
  • Beverages : covers alcoholic and non-alcoholic beverages and whether they’re available, for a fee or free

Accuracy

Our data is researched by our dedicated data team and comes from a diverse set of sources including:

  • Airline data provided directly to ATPCO
  • Airline websites, press releases and social channels
  • Travel blogs and websites (e.g., One Mile At A Time, Crankyflyer)
  • Industry publications (e.g., Aviation Week, Tnooz)
  • Traditional print publications (e.g, Seattle Times, WSJ)
  • Social media (e.g., YouTube, Facebook, Twitter, Instagram)
  • Suppliers (e.g., Thales, Astronics, Recaro)
  • Industry contacts (e.g., contacts with customers, personal contacts)
  • OAG schedule data

Language Translation

Amenities display text is available for the following languages/regions.

Language Language Code Region
Arabic ar (any)
Danish da (any)
Dutch nl (any)
English (Australia) en AU
English (Great Britain) en GB
English (India) en IN
English (Int’l) en (any)
English (USA) en US
Finnish fi (any)
French (Canada) fr CA
French (France) fr (any)
German (Deutschland) de DE
Greek el (any)
Hebrew he (any)
Indonesian id, in (any)
Italian it (any)
Japanese ja (any)
Korean ko (any)
Norwegian no (any)
Polish pl (any)
Portuguese (Brazil) pt BR
Portuguese (Europe) pt (any)
Russian ru (any)
Simplified Chinese zh CN
Spanish (Latin America) es (any)
Spanish (Spain) es ES
Swedish sv (any)
Thai th (any)
Traditional Chinese zh HK, TW
Turkish tr (any)
Vietnamese vi (any)

Units of Measurement

Measurement is dictated by the language/localization indicated. For the U.S. English, all measurements follow the United States customary system (USCS) for units of measurement. For all other languages/localizations, measurements are provided in metric units.