--- title: "Ticket Display" method: GET path: "/air/ticket/tickets/{Identifier}" tags: ["Ticketing", "Retrieve Bookings and Tickets"] --- # Ticket Display `GET /air/ticket/tickets/{Identifier}` GDS only. To retrieve an NDC ticket use the Ticket Retrieve API. This API duplicates functionality available in the more recently released Ticket Retrieve API, which for GDS can retrieve a single or multiple tickets. ## Path parameters - `Identifier` string, required ## Query parameters - `detailViewInd` boolean ## Headers - `travelportPlusSessionIdentifier` string - `TraceId` string - `XAUTH_TRAVELPORT_ACCESSGROUP` string - `TVP-PCC-Core` string ## Response `200` OK - Successful Response - 200 - TicketListResponseWrapper — Wrapper schema to expose the name of the top level schema in the JSON example - `TicketListResponse` TicketListResponse — Base response is part of all TripServices responses and includes common items which are relevant across all APIs - `TicketID` Ticket[] - `@type` string, required — Discriminator classes TicketID, Ticket, TicketSummary, or TicketDetail - `objID` string - `TicketRef` string - `Identifier` Identifier — A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination). - `value` string — Unique offer identifier that can be sent in subsequent payload requests to reference this offer. When used for reference flight calls, the CatalogProductOfferingsIdentifier will be the transaction identifier from the Search, Next Leg Search, or Flight Specific Search response in CatalogProductOfferings/Identifier/value. If you choose to pull the CatalogProductOfferingsIdentifier from the Price response instead (OfferListResponse/Identifier/value), either full or reference payload, please note for subsequent Add Offer requests you must remove the _PC appended to the end of the value in the AirPrice response (e.g., change value: '93d2091d-3d04-48ab-8091-6ae1525f02ea_PC' to value: '93d2091d-3d04-48ab-8091-6ae1525f02ea'). When building an AirPrice or Add Offer reference payload request: - Look for the CatalogProductOfferingIdentifier (ex: o1) in a Search response at CatalogProductOfferings/CatalogProductOffering/id or a Price response at OfferListResponse/OfferID/id. - Look for the ProductIdentifier (ex: p0) in a Search response at CatalogProductOfferings/CatalogProductOffering/ProductBrandOptions/ProductBrandOffering/Product/productRef or from a Price response at OfferListResponse/OfferID/Product/id. When returned from a Workbench, this value is the workbench identifier that must be sent in all subsequent requests for this workbench session. When returned from Air Exchange Eligibility, value is the ticket number sent with the eligibility request. When used specifically for form of payment, the value will begin with the characters 'FOP'. Similarly, the OfferIdentifier associated will begin with the character 'O'. For Hotel Create Reservation (Reference Payload), send the value from the Availability response in CatalogOffering/id or the value from SearchComplete returned in propertyItems/lowestPublicAvailableRate/rateKey/value. Results from Hotel Availability and Hotel SearchComplete are stored in the cache for 30 minutes. If the offers expire before booking, you must send a new request. - `authority` string — Name of the supplier system that created this identifier - the source of information. For AirPrice, please note that GDS offers return the value 'Travelport' in authority while NDC offers return the carrier code of the issuing NDC carrier. When returned from Air Exchange Eligibility, authority is always 'Travelport' as the transaction issuer. For Hotels, authority indicates which supplier returned the lowest available rate for that property: either 'TVPT' (Travelport) or 'BKNG' (booking.com). Booking.com access requires additional provisioning and a direct agreement with the supplier. Authority is not returned if the property is closed or returns an error. For Hotel Create Reservation (Full Payload) and Sync Reservation send the value from the Availability response in CatalogOffering/Identifier/authority for the instance you want to book. - `numberOfTicketsIssued` integer, required — The total number of tickets issued for the collection of flight segments example: 5 - `settlementAuthorizationCode` string — Electronic Settlement Authorization Code - A unique number generated by a Carrier to authorize or approve a transaction - `tourCode` string — A Tour Code on a flight ticket is a special code arranged between the Travel Agency and the Airlines - `accountCode` string — The Account Code used to classify financial activities - `ticketDesignator` string — A code on airline tickets to indicate what type of discount is applied - `PersonName` PersonName, required — Travelport+ limits the combination of Given and Surname to 22 characters. Given name must have at least one character. Any PersonName exceeding 22 characters is truncated in the response. - `@type` string, required — Discriminator classes PersonName or PersonNameDetail - `Prefix` string — Salutation of honorific (e.g. Mr., Mrs., Ms., Miss, Dr.) - `Given` string — Traveler first or given name. - `Middle` string — Traveler middle name. - `Surname` string, required — Traveler last name or surname. - `ReservationLocator` SupplierLocator — The supplier and the supplier's locator code for a product. - `value` string — The external or supplier-issued locator. - `supplierCode` string — Supplier Code; generally the releated IATA code for the carrier or agency. - `supplierName` string — Name of the supplier - `FormOfPayment` FormOfPayment[], required - `value` 'AgencyAccount' | 'BSP' | 'Cash' | 'Document' | 'Invoice' | 'PaymentCard' | 'WaiverCode' — The list of valid forms of payment. - `documentNumber` string — Payment document number - `encryptedValue` string — Encrypted value - `documentIssuer` string — Document issuer - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice' — Document type like EMD, MCO - `TicketSegment` TicketSegment[], required - `@type` string - `sequence` integer — The sequence of the coupon within the ticket - `ClassOfService` string — The booking class of service. segment - `FareBasisCode` string — The Fare Basis code for this ticket segment. - `Status` 'CheckedIn' | 'Closed' | 'Exchanged' | 'InfoOnly' | 'Lifted/Boarded' | 'OpenForUse' | 'OtherAirlineControl' | 'Void' | 'Refund' | 'Suspended' | 'Unavailable' | 'Used' - `Carrier` string, required — The marketing carrier of the flight on this ticket segment. - `Number` string, required — The flight number. - `Departure` Departure, required — Departure details for a given leg. - `@type` string, required — Discriminator classes Departure or DepartureDetail - `location` string, required — IATA code for departure airport or city for this leg of the itinerary. - `date` string, date, required — Departure date in YYYY-MM-DD format. - `time` string, required — Departure date in HH:mm:ss (24-hour format). - `Arrival` Arrival, required - `@type` string, required — Discriminator classes Arrival or ArrivalDetail - `location` string, required — IATA code for arrival airport or city for this leg of the itinerary. - `date` string, date, required — Arrival date in YYYY-MM-DD format. - `time` string — Arrival date in HH:mm:ss (24-hour format). - `FlightStatusCode` string, required — A status code indicates the status of an air segment - `ValidDateRange` DateRange — Specifies the begin and end date of an event, such as check-in and check-out dates. - `start` string, date, required — Specifies the start date for an event, such as a booking or check-in date in YYYY-MM-DD format. - `end` string, date, required — Specifies the end date an event, such as a booking or check-out date in YYYY-MM-DD format. - `TicketBaggage` TicketBaggage, required - `@type` string - `quantity` integer — How many baggage allowed - `Measurement` Measurement[] — The total dimensions of baggage - `value` number, float - `measurementType` 'Width' | 'Height' | 'Depth' | 'Weight' | 'OverallDimension' — The type of measurement such as width, height, weight - `unit` 'Miles' | 'Kilometers' | 'Meters' | 'Millimeters' | 'Centimeters' | 'Yards' | 'Feet' | 'Inches' | 'Pixels' | 'Block' | 'Megabytes' | 'Gigabytes' | 'Square feet' | 'Square meters' | 'Pounds' | 'Kilograms' | 'Square inch' | 'Square yard' | 'Acre' | 'Square millimeter' | 'Square centimeter' | 'Hectare' | 'Ounce' | 'Gram' | 'Gallons' | 'Liters' | 'Kilowatts' | 'Cubic meters' — The unit of measure in a code format. Refer to OpenTravel Code List Unit of Measure Code (UOM). - `soldByPieceInd` boolean — If true, the baggage item is sold as a piece allowance. Weight restrictions may also apply. - `soldByWeightInd` boolean — If true, the baggage item is sold as a weight allowance. Number of item restrictions may also apply. - `connectionInd` boolean — If true, the ticketSegment is a connecting segment - `TicketPrice` TicketPrice, required - `@type` string - `fareCalculation` string — Calculation of applicable fare - `fareBreakdown` string — An itinerary used as the start and finish of a particular fare - `CurrencyCode` CurrencyCode, required — Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency. - `value` string — An ISO 4217 currency code. - `codeAuthority` string — Currency code authority - `decimalPlace` integer — Number of decimal places for the currency. - `decimalAuthority` string — Currency code decimal authority - `Base` number, float, required - `Taxes` Taxes — Summary of all individual taxes. Child class TaxesDetail provides the breakdown of individual taxes. - `@type` string, required — Discriminator class is TaxesDetail - `TotalTaxes` number, float — A monetary amount, representing the total of all taxes included in this offer. Supports up to 4 decimal places; decimal place must be included. - `TaxInfo` TaxInfo[] — Returned for TripChange APIS only. - `@type` string - `TaxCode` string, required — The tax code - `CurrencyCode` CurrencyCode — Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency. - … - `Amount` number, float, required — The amount of the tax applied - `TaxBreakdown` TaxBreakdown[], required — The breakdown of the tax for this tax code - … - `Fees` Fees — Includes TotalFees object to return the sum total of any fees. May include array of Fee objects to break down individual fees. Child class FeesDetail may also include a breakdown of the individual fees. - `@type` string, required — Discriminator. Child class FeesDetail - `TotalFees` number, float — Total fees included in the TotalPrice. Supports up to 4 decimal places; decimal place needs to be included. - `TotalAdditionalFeesPayableLocally` number, float — Fees due separately at the property. Expected to be paid in local currency. These fees are not included in the Offer TotalPrice. - `Total` number, float, required - `Commission` Commission — GDS only; not supported for NDC. Commission information. Any commission filed by an airline in a CAT35 fare is returned in PriceBreakdownAir/Commission. The amount is either a percent of the fare component (@type CommissionPercent and the Percent object) or an amount (@type CommissionAmount and the Amount object). - `@type` string, required — Discriminator. Child classes CommissionAmount or CommissionPercent - `application` 'Full' | 'Partial' | 'Non-paying' | 'No-show' | 'Adjustment' | 'Commissionable' — Type of commission - `FiledAmount` FiledAmount — Returned only in the Price APIs. GDS only; not supported for NDC. The base amount of a ticket price or net price that is filed in local currency. Returned when the origin currency is not the same as the PCC currency to show the currency in which the base fare has been filed. When used for NetBaseAmount: Net ticket data (NTD) is returned in the AirPrice, AirReservation, Exchange Search, and Reservation Retrieve responses for any GDS fare that has a private fare component (fareType=AgencyPrivateFare). When NTD is returned, TermsAndConditionsFuill includes FareGuaranteePolicy to return the fare calculation indicator for the fare. When NTD is returned, PriceBreakdown may include NetBaseAmount. - `value` number, float — Filed amount value - `currencyCode` string — Code for the currency in which the base fare was filed. - `codeAuthority` string — Filed amount currency code authority - `decimalPlace` integer, required — Number of decimal places in the currency in ISO 4217 standard format. - `decimalAuthority` string — ISO 4217 standard decimal authority - `PaidTaxes` PaidTaxes — Summary Taxes object - `@type` string, required — Discriminator classes PaidTaxes or PaidTaxesDetail - `TotalTaxes` number, float — A monetary amount, up to 4 decimal places. Decimal place needs to be included. - `iTFareInd` boolean — if true, this is an IT fare and the base amount is not exposed - `bTFareInd` boolean — if true, this is a BT fare and the base amount is not exposed - `AdditionalCollection` FiledAmount — Returned only in the Price APIs. GDS only; not supported for NDC. The base amount of a ticket price or net price that is filed in local currency. Returned when the origin currency is not the same as the PCC currency to show the currency in which the base fare has been filed. When used for NetBaseAmount: Net ticket data (NTD) is returned in the AirPrice, AirReservation, Exchange Search, and Reservation Retrieve responses for any GDS fare that has a private fare component (fareType=AgencyPrivateFare). When NTD is returned, TermsAndConditionsFuill includes FareGuaranteePolicy to return the fare calculation indicator for the fare. When NTD is returned, PriceBreakdown may include NetBaseAmount. - `value` number, float — Filed amount value - `currencyCode` string — Code for the currency in which the base fare was filed. - `codeAuthority` string — Filed amount currency code authority - `decimalPlace` integer, required — Number of decimal places in the currency in ISO 4217 standard format. - `decimalAuthority` string — ISO 4217 standard decimal authority - `NetAmount` AlternateAmount - `amount` number, float, required — The base amount - `currencyCode` string, required — Amount currency code - `decimalPlace` integer, required — ISO 4217 decimal standard - `fareCalculation` string — the fare calculation string - `rateOfExchange` number, float — The rate of exchange used to convert the fare calculation - `PassengerTypeCode` string — Code used to identify Passengers according to various - `ValidatingCarrier` string — The plating carrier of the ticket - `PricingType` 'Auto Priced' | 'Manually Price' — How the price was created - `Restrictions` string[] — restrictions associated with a particular fare - `AgencyInfo` AgencyInfo — Detail of the travel agency that issues the ticket - `ticketedDate` string — Ticketed date - `name` string, required — Name of the Agency - `place` string — Place of the agency - `ticketingPCC` string — Ticketing PCC - `code` string — Agency code - `salesType` string — Sales type - `ticketingCountry` string, required — Ticketing country - `ticketingCity` string, required — Ticketing city - `OriginalIssue` OriginalIssue - `value` string - `issuingCity` string, required — Original Issuing city - `issueDate` string, required — Issue date - `agencyCodeIATA` string, required — Agency code - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice' — Document type like EMD, MCO - `PreviousIssue` PreviousIssue[] - `value` string - `issuingCity` string - `issueDate` string - `agencyCodeIATA` string - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice' — Document type like EMD, MCO - `SettlementAuthorizationCode` string - `@type` string - `transactionId` string — A unique system-generated (128 bit GUID format) transaction/tracking id for a single request and response (i.e. for a single transaction) used for internal tracking and troubleshooting. Also known as E2ETrackingId. Not returned in all Hotel API responses. - `traceId` string — Used in hospitality workflows to provide a unique transaction or tracking id for a single request and response. For Air Eligibility, returned if a custom trace ID was sent in the request header. For Hotel Rules, returned if a custom trace ID was sent in the request header. - `correlationId` string, uuid — Identifier used to correlate hotel API invocations across a multi-call business flows. - `reservationStatus` 'Success' | 'Fail' | 'Partial' | 'Pending' | 'OnHold' | 'Retry' | 'Other' — Status of reservation or offer completion. - `Result` Result — Returns the error and/or warning message information, if applicable. - `@type` string — Discriminator class Result only - `status` 'Not processed' | 'Incomplete' | 'Complete' | 'Unknown' — The status of an error or warning - `Error` Error[] — A list of error information returned at the provider level for a response. - `@type` string, required — Discriminator classes Error or ErrorDetail - `StatusCode` integer — Http standard response code - `Message` string — The Travelport standardized error or warning message - `NameValuePair` NameValuePair[] - `value` string — Text directly related to name description, providing more detail. May have character restrictions based on remark type (e.g. Free Text limitations: 84 characters, alphanumeric and some special characters). - `id` string — Optional internally referenced id - `name` string, required — Key, categorizing the type of remark or error. - `Warning` Warning[] — A list of warning information returned at the provider level for a response. - `@type` string, required — Discriminator classes Warning or WarningDetail - `StatusCode` integer — Http standard response code - `Message` string — The Travelport standardized error or warning message - `NameValuePair` NameValuePair[] - `value` string — Text directly related to name description, providing more detail. May have character restrictions based on remark type (e.g. Free Text limitations: 84 characters, alphanumeric and some special characters). - `id` string — Optional internally referenced id - `name` string, required — Key, categorizing the type of remark or error. - `Identifier` Identifier — A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination). - `value` string — Unique offer identifier that can be sent in subsequent payload requests to reference this offer. When used for reference flight calls, the CatalogProductOfferingsIdentifier will be the transaction identifier from the Search, Next Leg Search, or Flight Specific Search response in CatalogProductOfferings/Identifier/value. If you choose to pull the CatalogProductOfferingsIdentifier from the Price response instead (OfferListResponse/Identifier/value), either full or reference payload, please note for subsequent Add Offer requests you must remove the _PC appended to the end of the value in the AirPrice response (e.g., change value: '93d2091d-3d04-48ab-8091-6ae1525f02ea_PC' to value: '93d2091d-3d04-48ab-8091-6ae1525f02ea'). When building an AirPrice or Add Offer reference payload request: - Look for the CatalogProductOfferingIdentifier (ex: o1) in a Search response at CatalogProductOfferings/CatalogProductOffering/id or a Price response at OfferListResponse/OfferID/id. - Look for the ProductIdentifier (ex: p0) in a Search response at CatalogProductOfferings/CatalogProductOffering/ProductBrandOptions/ProductBrandOffering/Product/productRef or from a Price response at OfferListResponse/OfferID/Product/id. When returned from a Workbench, this value is the workbench identifier that must be sent in all subsequent requests for this workbench session. When returned from Air Exchange Eligibility, value is the ticket number sent with the eligibility request. When used specifically for form of payment, the value will begin with the characters 'FOP'. Similarly, the OfferIdentifier associated will begin with the character 'O'. For Hotel Create Reservation (Reference Payload), send the value from the Availability response in CatalogOffering/id or the value from SearchComplete returned in propertyItems/lowestPublicAvailableRate/rateKey/value. Results from Hotel Availability and Hotel SearchComplete are stored in the cache for 30 minutes. If the offers expire before booking, you must send a new request. - `authority` string — Name of the supplier system that created this identifier - the source of information. For AirPrice, please note that GDS offers return the value 'Travelport' in authority while NDC offers return the carrier code of the issuing NDC carrier. When returned from Air Exchange Eligibility, authority is always 'Travelport' as the transaction issuer. For Hotels, authority indicates which supplier returned the lowest available rate for that property: either 'TVPT' (Travelport) or 'BKNG' (booking.com). Booking.com access requires additional provisioning and a direct agreement with the supplier. Authority is not returned if the property is closed or returns an error. For Hotel Create Reservation (Full Payload) and Sync Reservation send the value from the Availability response in CatalogOffering/Identifier/authority for the instance you want to book. - `NextSteps` NextSteps — Container for the steps that describe actions that may be taken on the containing object. Not applicable for an Eligibility or Exchange response. - `baseURI` string, required — The base portion of the URI in order to shorten the uris in the individual steps - `id` string — Optional internally referenced id - `NextStep` NextStep[], required - `value` string - `id` string — Identifier for the Next Step - `action` string, required — The action this next step is intended to achieve - `method` 'GET' | 'DELETE' | 'PUT' | 'POST', required — Describes the set of potential methods that can be taken after an operation. - `description` string — Additional clarification for the next step - `ReferenceList` ReferenceList[] - `@type` string, required — Discriminator - Air Search child classes are ReferenceListAmenity, ReferenceListBrand, ReferenceListFlight, ReferenceListProduct, ReferenceListTermsAndConditions, and ReferenceListUniversalProductAttribute. - Air Price child classes are ReferenceListAmenity and ReferenceListBrand. - FareRules child class is ReferenceListFlight. - Search Ancillaries child class is ReferenceListFlight. - Seat Map child class is ReferenceListSeatingChart. - Hotel Availability child class is ReferenceListPropertyDates. - Reservation and Reservation Workbench child classes are ReferenceListAmenity, ReferenceListBrand, and ReferenceListUniversalProductAttribute. - Exchange Search child classes are ReferenceListBrand, ReferenceListFlight, and ReferenceListExchangedPrice. - Reservation Receipt child classes are ReferenceListOffer and ReferenceListTraveler. - Book_Traveler child class is ReferenceListTraveler. - `id` string — Uniquely identifies for the Reference List - `CurrencyRateConversion` CurrencyRateConversion[] - `@type` string - `SourceCurrency` CurrencyCode, required — Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency. - `value` string — An ISO 4217 currency code. - `codeAuthority` string — Currency code authority - `decimalPlace` integer — Number of decimal places for the currency. - `decimalAuthority` string — Currency code decimal authority - `TargetCurrency` CurrencyCode, required — Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency. - `value` string — An ISO 4217 currency code. - `codeAuthority` string — Currency code authority - `decimalPlace` integer — Number of decimal places for the currency. - `decimalAuthority` string — Currency code decimal authority - `ConversionRate` ConversionRate, required — Conversion rate of SourceCurrency value to TargetCurrency value. This value can be used to calculate, independently of the API, conversion for the rates in the response. The response does not convert any amounts. - `value` number, float - `rateAuthority` string — Contextual rate authority - `rateAsOf` string, date-time — Rate as of - `Pagination` Pagination — Pagination object used when result sets span across a number of pages. - `@type` string, required - `page` integer, required — The current page number of the full result set - `pageSize` integer, required — The total number of items on this page - `totalPages` integer, required — The total number of pages in this result set - `totalItems` integer, required — The total number of pages in this result set ## Other responses - `400` — Bad Request - 400 - `401` — Unauthorized - 401 - `402` — Payment Required - 402 - `403` — Forbidden - 403 - `404` — Not Found - 404 - `500` — Internal Server Error - 500 - `503` — Service Unavailable - 503. This error may be returned when the service is temporarily unavailable due to infrastructure or network issues. --- [API](https://skmtc.net/travelport/apis/tripservices-flights.md) · [All operations](https://skmtc.net/travelport/apis/tripservices-flights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/travelport/tripservices-flights/revisions/90abcc916990/schema)