Sample 2: Requesting UTAs

Austin Schneider -

Universal Ticket Attributes (UTAs) are specific attributes of a fare, e.g. ticket refundability, structured using standardized terms and airline specific marketing language. As with UPAs, UTAs are targeted down to the flight cabin and further segmented by category and fare brand. Each UTA represents a single ticket attribute with standardized headlines, descriptive text, an icon, and a link to more information. Below is an example request and response for requesting UTAs only.

Request

curl \
"YOUR_HOST/legs_searches?include=legs.leg_fares.utas" \
-X POST \
-H "Auth: YOUR_API_KEY" \
-H "Content-Type: application/vnd.routehappy+json" \
-H "Accept: application/vnd.routehappy+json" \
-H "Accept-language: en" \
-d '{
  "data": {
    "type": "legs_search",
    "attributes": {
      "legs": [
        {
          "key": "YYC-YYZ-TS-846-20180523-ECON~YYZ-AMS-TS-360-20180523-ECON"
        }
      ]
    }
  }
}'

Response

{
  "data": {
    "type": "legs_search",
    "id": "64c57292-df44-119d-e4df-94bce6a8c79b",
    "relationships": {
      "legs": {
        "data": [
          {
            "type": "leg",
            "id": "1~2",
            "meta": {
              "index": 0
            }
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "leg",
      "id": "1~2",
      "relationships": {
        "leg_fares": {
          "data": [
            {
              "type": "leg_fare",
              "id": "1~2|54"
            },
            {
              "type": "leg_fare",
              "id": "1~2|51"
            },
            {
              "type": "leg_fare",
              "id": "1~2|52"
            },
            {
              "type": "leg_fare",
              "id": "1~2|53"
            }
          ]
        }
      }
    },
    {
      "type": "uta",
      "id": "208204",
      "attributes": {
        "headline": "For $300-350",
        "description": "Advance change allowed for $300-350",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/09fc650a-57ab-42f6-93fa-4a9ab4949d1f/small/flight_schedule.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/09fc650a-57ab-42f6-93fa-4a9ab4949d1f/large/flight_schedule.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares?isPopup=true",
        "assessment": "neutral",
        "categories": [
          "advance-change"
        ],
        "fees": [
          {
            "currency_code": "CAD",
            "amount_min": "300.00",
            "amount_max": "350.00"
          },
          {
            "currency_code": "USD",
            "amount_min": "300.00",
            "amount_max": "350.00"
          }
        ]
      }
    },
    {
      "type": "uta",
      "id": "208205",
      "attributes": {
        "headline": "Non-refundable",
        "description": "Non-refundable",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/small/cancelation.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/large/cancelation.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "restriction",
        "categories": [
          "cancellation"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208241",
      "attributes": {
        "headline": "1st free",
        "description": "1st checked bag free",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/d34a33cb-6a0c-4b6e-ab84-6e009a353f27/small/weight_size.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/d34a33cb-6a0c-4b6e-ab84-6e009a353f27/large/weight_size.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/Baggage/Weight-Dimensions",
        "assessment": "benefit",
        "categories": [
          "checked-bag-allowance"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208225",
      "attributes": {
        "headline": "1 free & personal item",
        "description": "1 carry on bag & personal item",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/e687cef0-d277-4850-9cdb-17b520fc4048/small/children_alone.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/e687cef0-d277-4850-9cdb-17b520fc4048/large/children_alone.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/Baggage/Weight-Dimensions",
        "assessment": "benefit",
        "categories": [
          "carry-on-allowance"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208230",
      "attributes": {
        "headline": "Assigned or $30",
        "description": "Seat assigned or select anytime $30",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/c48fe004-a3e0-4dfc-8a06-dc5ded4b5da9/small/seat_selection.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/c48fe004-a3e0-4dfc-8a06-dc5ded4b5da9/large/seat_selection.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares?isPopup=true",
        "assessment": "restriction",
        "categories": [
          "seat-selection"
        ],
        "fees": [
          {
            "currency_code": "CAD",
            "amount_min": "30.00",
            "amount_max": null
          },
          {
            "currency_code": "USD",
            "amount_min": "30.00",
            "amount_max": null
          }
        ]
      }
    },
    {
      "type": "uta",
      "id": "208223",
      "attributes": {
        "headline": "Standard",
        "description": "Standard check-in priority",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/1b108243-7adf-4d68-88a2-8b3076e22a35/small/airport_check-in.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/1b108243-7adf-4d68-88a2-8b3076e22a35/large/airport_check-in.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "neutral",
        "categories": [
          "check-in-priority"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208221",
      "attributes": {
        "headline": "Standard",
        "description": "Standard boarding",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/695c11e2-e587-48d4-8b38-b2ef136792e2/small/traveler.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/695c11e2-e587-48d4-8b38-b2ef136792e2/large/traveler.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "neutral",
        "categories": [
          "boarding-priority"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208219",
      "attributes": {
        "headline": "For a fee",
        "description": "Upgrade for a fee",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/30dbe2ba-1e85-4cc6-a338-d15e00911dbf/small/club.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/30dbe2ba-1e85-4cc6-a338-d15e00911dbf/large/club.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/book/book-a-flight/on-board-comfort/club-class",
        "assessment": "neutral",
        "categories": [
          "upgrade-eligibility"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208217",
      "attributes": {
        "headline": "For a fee",
        "description": "Lounge access for a fee",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/a644c963-50ef-47bf-b046-d465dbe0ee5a/small/clipper-cosmo.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/a644c963-50ef-47bf-b046-d465dbe0ee5a/large/clipper-cosmo.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/Airports-and-check-in/Lounges",
        "assessment": "neutral",
        "categories": [
          "lounge-access"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208211",
      "attributes": {
        "headline": "Refund for $350",
        "description": "Ticket refund for $350",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/small/cancelation.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/large/cancelation.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "neutral",
        "categories": [
          "cancellation"
        ],
        "fees": [
          {
            "currency_code": "CAD",
            "amount_min": "350.00",
            "amount_max": null
          },
          {
            "currency_code": "USD",
            "amount_min": "350.00",
            "amount_max": null
          }
        ]
      }
    },
    {
      "type": "uta",
      "id": "208203",
      "attributes": {
        "headline": "For $150",
        "description": "Advance change allowed for $150",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/09fc650a-57ab-42f6-93fa-4a9ab4949d1f/small/flight_schedule.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/09fc650a-57ab-42f6-93fa-4a9ab4949d1f/large/flight_schedule.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares?isPopup=true",
        "assessment": "neutral",
        "categories": [
          "advance-change"
        ],
        "fees": [
          {
            "currency_code": "CAD",
            "amount_min": "150.00",
            "amount_max": null
          },
          {
            "currency_code": "USD",
            "amount_min": "150.00",
            "amount_max": null
          }
        ]
      }
    },
    {
      "type": "uta",
      "id": "208212",
      "attributes": {
        "headline": "Refund for $250",
        "description": "Ticket refund for $250",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/small/cancelation.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/large/cancelation.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "neutral",
        "categories": [
          "cancellation"
        ],
        "fees": [
          {
            "currency_code": "CAD",
            "amount_min": "250.00",
            "amount_max": null
          },
          {
            "currency_code": "USD",
            "amount_min": "250.00",
            "amount_max": null
          }
        ]
      }
    },
    {
      "type": "uta",
      "id": "208238",
      "attributes": {
        "headline": "1st free",
        "description": "1st checked bag free",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/d34a33cb-6a0c-4b6e-ab84-6e009a353f27/small/weight_size.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/d34a33cb-6a0c-4b6e-ab84-6e009a353f27/large/weight_size.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/Baggage/Weight-Dimensions",
        "assessment": "benefit",
        "categories": [
          "checked-bag-allowance"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208226",
      "attributes": {
        "headline": "Anytime",
        "description": "Select seat anytime",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/c48fe004-a3e0-4dfc-8a06-dc5ded4b5da9/small/seat_selection.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/c48fe004-a3e0-4dfc-8a06-dc5ded4b5da9/large/seat_selection.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares?isPopup=true",
        "assessment": "benefit",
        "categories": [
          "seat-selection"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208188",
      "attributes": {
        "headline": "Free",
        "description": "Advance change allowed for free",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/09fc650a-57ab-42f6-93fa-4a9ab4949d1f/small/flight_schedule.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/09fc650a-57ab-42f6-93fa-4a9ab4949d1f/large/flight_schedule.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares?isPopup=true",
        "assessment": "benefit",
        "categories": [
          "advance-change"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208213",
      "attributes": {
        "headline": "Refund for $50",
        "description": "Ticket refund for $50",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/small/cancelation.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/dce399c9-2f3e-4cbb-9c1a-cc95a68869f0/large/cancelation.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "neutral",
        "categories": [
          "cancellation"
        ],
        "fees": [
          {
            "currency_code": "CAD",
            "amount_min": "50.00",
            "amount_max": null
          },
          {
            "currency_code": "USD",
            "amount_min": "50.00",
            "amount_max": null
          }
        ]
      }
    },
    {
      "type": "uta",
      "id": "208235",
      "attributes": {
        "headline": "2 free",
        "description": "2 free checked bags",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/d34a33cb-6a0c-4b6e-ab84-6e009a353f27/small/weight_size.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/d34a33cb-6a0c-4b6e-ab84-6e009a353f27/large/weight_size.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/Baggage/Weight-Dimensions",
        "assessment": "benefit",
        "categories": [
          "checked-bag-allowance"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "208222",
      "attributes": {
        "headline": "Priority",
        "description": "Priority check-in provided for free",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/1b108243-7adf-4d68-88a2-8b3076e22a35/small/airport_check-in.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/1b108243-7adf-4d68-88a2-8b3076e22a35/large/airport_check-in.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "benefit",
        "categories": [
          "check-in-priority"
        ],
        "fees": []
      }
    },
    {
      "type": "uta",
      "id": "204584",
      "attributes": {
        "headline": "Priority",
        "description": "Priority boarding provided for free",
        "small_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/695c11e2-e587-48d4-8b38-b2ef136792e2/small/traveler.png?channel_id=ot5j870v",
        "large_icon_url": "https://d13cihc9138cdj.cloudfront.net/icons/695c11e2-e587-48d4-8b38-b2ef136792e2/large/traveler.png?channel_id=ot5j870v",
        "cta_text": "More",
        "cta_url": "https://www.airtransat.com/en-CA/Travel-information/fare-options/eco-fares",
        "assessment": "benefit",
        "categories": [
          "boarding-priority"
        ],
        "fees": []
      }
    },
    {
      "type": "leg_fare",
      "id": "1~2|54",
      "relationships": {
        "utas": {
          "data": [
            {
              "type": "uta",
              "id": "208204"
            },
            {
              "type": "uta",
              "id": "208205"
            },
            {
              "type": "uta",
              "id": "208241"
            },
            {
              "type": "uta",
              "id": "208225"
            },
            {
              "type": "uta",
              "id": "208230"
            },
            {
              "type": "uta",
              "id": "208223"
            },
            {
              "type": "uta",
              "id": "208221"
            },
            {
              "type": "uta",
              "id": "208219"
            },
            {
              "type": "uta",
              "id": "208217"
            }
          ]
        }
      }
    },
    {
      "type": "leg_fare",
      "id": "1~2|51",
      "relationships": {
        "utas": {
          "data": [
            {
              "type": "uta",
              "id": "208204"
            },
            {
              "type": "uta",
              "id": "208211"
            },
            {
              "type": "uta",
              "id": "208241"
            },
            {
              "type": "uta",
              "id": "208225"
            },
            {
              "type": "uta",
              "id": "208230"
            },
            {
              "type": "uta",
              "id": "208223"
            },
            {
              "type": "uta",
              "id": "208221"
            },
            {
              "type": "uta",
              "id": "208219"
            },
            {
              "type": "uta",
              "id": "208217"
            }
          ]
        }
      }
    },
    {
      "type": "leg_fare",
      "id": "1~2|52",
      "relationships": {
        "utas": {
          "data": [
            {
              "type": "uta",
              "id": "208203"
            },
            {
              "type": "uta",
              "id": "208212"
            },
            {
              "type": "uta",
              "id": "208238"
            },
            {
              "type": "uta",
              "id": "208225"
            },
            {
              "type": "uta",
              "id": "208226"
            },
            {
              "type": "uta",
              "id": "208223"
            },
            {
              "type": "uta",
              "id": "208221"
            },
            {
              "type": "uta",
              "id": "208219"
            },
            {
              "type": "uta",
              "id": "208217"
            }
          ]
        }
      }
    },
    {
      "type": "leg_fare",
      "id": "1~2|53",
      "relationships": {
        "utas": {
          "data": [
            {
              "type": "uta",
              "id": "208188"
            },
            {
              "type": "uta",
              "id": "208213"
            },
            {
              "type": "uta",
              "id": "208235"
            },
            {
              "type": "uta",
              "id": "208225"
            },
            {
              "type": "uta",
              "id": "208226"
            },
            {
              "type": "uta",
              "id": "208222"
            },
            {
              "type": "uta",
              "id": "204584"
            },
            {
              "type": "uta",
              "id": "208219"
            },
            {
              "type": "uta",
              "id": "208217"
            }
          ]
        }
      }
    }
  ]
}
Have more questions? Submit a request