---
title: SemanticTags
framework: walletpasses
role: symbol
role_heading: Object
path: walletpasses/semantictags
---

# SemanticTags

An object that contains machine-readable metadata the system uses to offer a pass and suggest related actions.

## Declaration

```data
object SemanticTags
```

## Properties

additionalTicketAttributes: Additional ticket attributes that other tags or keys in the pass don’t include. Use this key for any type of event ticket. admissionLevel: The level of admission the ticket provides, such as general admission, VIP, and so forth. Use this key for any type of event ticket. admissionLevelAbbreviation: An abbreviation of the level of admission the ticket provides, such as GA or VIP. Use this key for any type of event ticket. airlineCode: The IATA airline code, such as EX for flightCode EX123. Use this key only for airline boarding passes. albumIDs: An array of the Apple Music persistent ID for each album corresponding to the event, in decreasing order of significance. Use this key for any type of event ticket. artistIDs: An array of the Apple Music persistent ID for each artist performing at the event, in decreasing order of significance. Use this key for any type of event ticket. attendeeName: The name of the person the ticket grants admission to. Use this key for any type of event ticket. awayTeamAbbreviation: The unique abbreviation of the away team’s name. Use this key only for a sports event ticket. awayTeamLocation: The home location of the away team. Use this key only for a sports event ticket. awayTeamName: The name of the away team. Use this key only for a sports event ticket. balance: The current balance redeemable with the pass. Use this key only for a store card pass. boardingGroup: A group number for boarding. Use this key for any type of boarding pass. boardingSequenceNumber: A sequence number for boarding. Use this key for any type of boarding pass. boardingZone: A zone number for boarding. Don’t include the word zone. carNumber: The number of the passenger car. A train car is also called a carriage, wagon, coach, or bogie in some countries. Use this key only for a train or other rail boarding pass. confirmationNumber: A booking or reservation confirmation number. Use this key for any type of boarding pass. currentArrivalDate: The updated date and time of arrival, if different from the originally scheduled date and time. Use this key for any type of boarding pass. currentBoardingDate: The updated date and time of boarding, if different from the originally scheduled date and time. Use this key for any type of boarding pass. currentDepartureDate: The updated departure date and time, if different from the originally scheduled date and time. Use this key for any type of boarding pass. departureAirportCode: The IATA airport code for the departure airport, such as MPM or LHR. Use this key only for airline boarding passes. departureAirportName: The full name of the departure airport, such as Maputo International Airport. Use this key only for airline boarding passes. departureLocationSecurityPrograms: A list of security programs that exist at the departure location. This only shows in the UI if a program is in passengerEligibleSecurityPrograms and at least one of departureLocationSecurityPrograms or destinationLocationSecurityPrograms. departureLocationTimeZone: The time zone of the departure location, such as America/Chicago. See the IANA Time Zone Database for the full list of supported time zones. departureCityName: The name of the departure city to display on the boarding pass, such as London or Shanghai. departureGate: The gate number or letters of the departure gate, such as 1A. Don’t include the word gate. departureLocation: An object that represents the geographic coordinates of the transit departure location, suitable for display on a map. If possible, use precise locations, which are more useful to travelers; for example, the specific location of an airport gate. Use this key for any type of boarding pass. departureLocationDescription: A brief description of the departure location. For example, for a flight departing from an airport that has a code of LHR, an appropriate description might be London, Heathrow. Use this key for any type of boarding pass. departurePlatform: The name of the departure platform, such as A. Don’t include the word platform. Use this key only for a train or other rail boarding pass. departureStationName: The name of the departure station, such as 1st Street Station. Use this key only for a train or other rail boarding pass. departureTerminal: The name or letter of the departure terminal, such as A. Don’t include the word terminal. Use this key only for airline boarding passes. destinationAirportCode: The IATA airport code for the destination airport, such as MPM or LHR. Use this key only for airline boarding passes. destinationAirportName: The full name of the destination airport, such as London Heathrow. Use this key only for airline boarding passes. destinationLocationSecurityPrograms: A list of security programs that exist at the destination location. This only shows in the UI if a program is in passengerEligibleSecurityPrograms and at least one of departureLocationSecurityPrograms or destinationLocationSecurityPrograms. destinationLocationTimeZone: The time zone of the destination location, such as America/Los_Angeles. See the IANA Time Zone Database for the full list of supported time zones. destinationCityName: The name of the destination city to display on the boarding pass, such as London or Shanghai. destinationGate: The gate number or letter of the destination gate, such as 1A. Don’t include the word gate. Use this key only for airline boarding passes. destinationLocation: An object that represents the geographic coordinates of the transit departure location, suitable for display on a map. Use this key for any type of boarding pass. destinationLocationDescription: A brief description of the destination location. For example, for a flight arriving at an airport that has a code of MPM, Maputo might be an appropriate description. Use this key for any type of boarding pass. destinationPlatform: The name of the destination platform, such as A. Don’t include the word platform. Use this key only for a train or other rail boarding pass. destinationStationName: The name of the destination station, such as 1st Street Station. Use this key only for a train or other rail boarding pass. destinationTerminal: The terminal name or letter of the destination terminal, such as A. Don’t include the word terminal. Use this key only for airline boarding passes. duration: The duration of the event or transit journey, in seconds. Use this key for any type of boarding pass and any type of event ticket. entranceDescription: The long description of the entrance information. Use this key for any type of event ticket. eventEndDate: The date and time the event ends. Use this key for any type of event ticket. eventName: The full name of the event, such as the title of a movie. Use this key for any type of event ticket. eventStartDate: The date and time the event starts. Use this key for any type of event ticket. eventStartDateInfo: An object that provides information for the date and time the event starts. Use this key for any type of event ticket. eventType: The type of event. Use this key for any type of event ticket. flightCode: The IATA flight code, such as EX123. Use this key only for airline boarding passes. flightNumber: The numeric portion of the IATA flight code, such as 123 for flightCode EX123. Use this key only for airline boarding passes. genre: The genre of the performance, such as classical. Use this key for any type of event ticket. homeTeamAbbreviation: The unique abbreviation of the home team’s name. Use this key only for a sports event ticket. homeTeamLocation: The home location of the home team. Use this key only for a sports event ticket. homeTeamName: The name of the home team. Use this key only for a sports event ticket. internationalDocumentsAreVerified: An optional boolean that indicates whether the passenger’s international documents are verified. If set to true Wallet displays the badge on the boarding pass with the value from internationalDocumentsVerifiedDeclarationName. internationalDocumentsVerifiedDeclarationName: The name of the declaration given once the passenger’s international documents are verified. Examples include DOCS OK or Travel Ready. If internationalDocumentsAreVerified is true, Wallet displays a badge on the boarding pass with this value. leagueAbbreviation: The abbreviated league name for a sports event. Use this key only for a sports event ticket. leagueName: The unabbreviated league name for a sports event. Use this key only for a sports event ticket. loungePlaceIDs: The MapKit Place IDs that reference the transit provider lounge locations. For more information, see Identifying unique locations with Place IDs. membershipProgramName: The name of a frequent flyer or loyalty program. Use this key for any type of boarding pass. membershipProgramNumber: The ticketed passenger’s frequent flyer or loyalty number. Use this key for any type of boarding pass. membershipProgramStatus: The ticketed passenger’s frequent flyer or loyalty program status. Use this key for any type of boarding pass. originalArrivalDate: The originally scheduled date and time of arrival. Use this key for any type of boarding pass. originalBoardingDate: The originally scheduled date and time of boarding. Use this key for any type of boarding pass. originalDepartureDate: The originally scheduled date and time of departure. Use this key for any type of boarding pass. passengerAirlineSSRs: An array of airline-specific SSRs that apply to the ticketed passenger. passengerCapabilities: A list of capabilities the passenger has. Only use this key for airline boarding passes. passengerEligibleSecurityPrograms: A list of security programs the passenger is eligible for. This only shows in the UI if a program is in passengerEligibleSecurityPrograms and at least one of departureLocationSecurityPrograms or destinationLocationSecurityPrograms. passengerInformationSSRs: An array of IATA information SSRs that apply to the ticketed passenger. A comprehensive list of service SSRs can be found in the the IATA Airlines Developer Guide under A List of Information SSRs. passengerName: An object that represents the name of the passenger. Use this key for any type of boarding pass. passengerServiceSSRs: An array of IATA SSRs that apply to the ticketed passenger. A comprehensive list of service SSRs can be found in the IATA Airlines Developer Guide under A List of Service SSRs. performerNames: An array of the full names of the performers and opening acts at the event, in decreasing order of significance. Use this key for any type of event ticket. playlistIDs: An array of the Apple Music persistent ID for each playlist corresponding to the event, in decreasing order of significance. Use this key for any type of event ticket. priorityStatus: The priority status the ticketed passenger holds, such as Gold or Silver. Use this key for any type of boarding pass. seats: An array of objects that represent the details for each seat at an event or on a transit journey. Use this key for any type of boarding pass or event ticket. securityScreening: The type of security screening for the ticketed passenger, such as Priority. Use this key for any type of boarding pass. silenceRequested: A Boolean value that determines whether the person’s device remains silent during an event or transit journey. The system may override the key and determine the length of the period of silence. Use this key for any type of boarding pass or event ticket. sportName: The commonly used name of the sport. Use this key only for a sports event ticket. tailgatingAllowed: A Boolean value that indicates whether tailgating is allowed at the event. Use this key for any type of event ticket. ticketFareClass: A localizable string that denotes the ticket class, such as Saver, Economy, First. This value displays as a badge on the boarding pass. totalPrice: The total price for the pass. Use this key for any pass type. transitProvider: The name of the transit company. Use this key for any type of boarding pass. transitStatus: A brief description of the current boarding status for the vessel, such as On Time or Delayed. For delayed status, provide currentBoardingDate, currentDepartureDate, and currentArrivalDate where available. Use this key for any type of boarding pass. transitStatusReason: A brief description that explains the reason for the current transitStatus, such as Thunderstorms. Use this key for any type of boarding pass. vehicleName: The name of the vehicle to board, such as the name of a boat. Use this key for any type of boarding pass. vehicleNumber: The identifier of the vehicle to board, such as the aircraft registration number or train number. Use this key for any type of boarding pass. vehicleType: A brief description of the type of vehicle to board, such as the model and manufacturer of a plane or the class of a boat. Use this key for any type of boarding pass. venueBoxOfficeOpenDate: The date when the box office opens. Use this key for any type of event ticket. venueCloseDate: The date when the venue closes. Use this key for any type of event ticket. venueDoorsOpenDate: The date the doors to the venue open. Use this key for any type of event ticket. venueEntrance: The full name of the entrance, such as Gate A, to use to gain access to the ticketed event. Use this key for any type of event ticket. venueEntranceDoor: The venue entrance door. Use this key for any type of event ticket. venueEntranceGate: The venue entrance gate. Use this key for any type of event ticket. venueEntrancePortal: The venue entrance portal. Use this key for any type of event ticket. venueFanZoneOpenDate: The date the fan zone opens. Use this key for any type of event ticket. venueGatesOpenDate: The date the gates to the venue open. Use this key for any type of event ticket. venueLocation: An object that represents the geographic coordinates of the venue. Use this key for any type of event ticket. venueName: The full name of the venue. Use this key for any type of event ticket. venueOpenDate: The date when the venue opens. Use this if none of the more specific venue open tags apply. Use this key for any type of event ticket. venueParkingLotsOpenDate: The date the parking lots open. Use this key for any type of event ticket. venuePhoneNumber: The phone number for inquiries about the venue’s ticketed event. Use this key for any type of event ticket. venueRegionName: The name of the city or hosting region of the venue. Use this key for any type of event ticket. venueRoom: The full name of the room where the ticketed event is to take place. Use this key for any type of event ticket. wifiAccess: An array of objects that represent the Wi-Fi networks associated with the event; for example, the network name and password associated with a developer conference. Use this key for any type of pass.

## Mentioned in

Creating an airline boarding pass using semantic tags Creating a poster event pass using semantic tags Supporting semantic tags in Wallet passes

## See Also

### Related Documentation

- [Supporting semantic tags in Wallet passes](walletpasses/supporting-semantic-tags-in-wallet-passes.md)
- [SemanticTagType](walletpasses/semantictagtype.md)

### Boarding passes

- [Creating an airline boarding pass using semantic tags](walletpasses/creating-an-airline-boarding-pass-using-semantic-tags.md)
- [Pass.BoardingPass](walletpasses/pass/boardingpass-data.dictionary.md)
- [SemanticTagType](walletpasses/semantictagtype.md)