Tour

Tours are included by default when responding to a request for UPAs. You can explicitly request tours by setting "disable_upa_tour": false. You can also request that photos not be returned with UPAs by setting "disable_upa_tour": true.

Copy

Copied

// Use "disable_upa_tour" key in request body:
{
  "control": {
  	"includes": [
  	  "upa"							// response should return UPAs
  	],
    "disable_upa_tour": false,		// use true to omit UPA tours from the response
    								// optional, defaults to false
    // ...
  }
// ...
}

Response

General Attributes

These attributes apply to photo, video, and tour UPAs.

Attributes	Type	Description/Value
headline	string	Headline, up to 40 characters
description	string	Description, up to 140 characters
small_icon_url	string	URL for the 42x42 icon
large_icon_url	string	URL for the 84x84 icon
cta_text	string	Link text for cta_url
cta_url	string	External URL where the end user can learn more
categories	array	Category IDs for Flight: aircraft, seat, meals, beverages, entertainment, power, wi-fi, service-inflight, upgrade. Other additional Category IDs : transport-to-airport, check-in, departure-terminal, department-lounge, gate-boarding, service-departure, stopover, connecting-ease, connecting-terminal, connecting-lounge, service-connecting, baggage-collection, arrival-terminal, arrival-lounge, arrival-transport, service-arrival, schedule-route, loyalty-program, brand, promotion.
fees	array	Additional fees. Elements are objects with members: currency_code (string), amount_min (string), amount_max (string or null)
source	string	The source of the UPA. Possible values include: `ATPCO` or `airline`

Tour-specific Attributes

These attributes apply to tour UPAs.

Attributes	Type	Description/Value
caption	string	Tour caption
image_thumb_url	string	URL to the 150x150 image
image_medium_square_url	string	URL to the 350x350 image
embed_url	string	Used for construction of the embed code.