---
title: "Document History"
method: POST
path: "/documents/history"
tags: ["Retrieve Bookings and Tickets"]
---

# Document History

`POST /documents/history`

## Headers

- `TraceId` string
- `XAUTH_TRAVELPORT_ACCESSGROUP` string
- `travelportPlusSessionIdentifier` string
- `TVP-PCC-Core` string

## Request body

- DocumentHistoryQueryRequest — Request payload to retrieve one to many documents, by Locator or by number. When requesting an invoice, if multiple instances of the invoice exists only the latest will be returned. Alternatively include the locator and the invoice number. Payload must include either locator or documentNumber or both.
  - `locator` string — For GDS locator max length is 6.
  - `documentNumbers` DocumentNumberType[]
    - `number` string, required — The document number.
    - `numberOfConjunctiveTickets` integer
    - `documentType` 'TKT' | 'EMD' | 'MCO' | 'INV' | 'TASF', required

## Response `200`

OK - Successful response

- DocumentHistoryResponseWrapper — Wrapper schema to expose the name of the top level schema in the JSON example
  - `DocumentHistoryResponse` DocumentHistoryResponse — Base response is part of all TripServices responses and includes common items which are relevant across all APIs
    - `documentHistories` DocumentHistory[]
      - `number` DocumentNumberType — The document number with the type of document
        - `number` string, required — The document number.
        - `numberOfConjunctiveTickets` integer
        - `documentType` 'TKT' | 'EMD' | 'MCO' | 'INV' | 'TASF', required
      - `issueDateTimeUTC` string, date-time — The issue date time of the document in GMT.
      - `issuingGTID` string — The issuing terminal ID.
      - `issuingAgent` string — The document issuing agent initials.
      - `issuingPseudoCityCode` string — The document issuing pseudo city code.
      - `issuingIATA` string — The document issuing IATA number.
      - `issuingAgencyName` string — The name of the issuing agency.
      - `issuingAgencyLocation` string — The city location of the issuing agency.
      - `countryCode` string — ISO Code of a Country.
      - `travelportLocator` Locator — Locator information for the reservation. Contains the locator (PNR or external locator) or cancellation number for the reservation, order, or offer.
        - `value` string — Reference number for locatorType. Booking.com returns a PIN number along with the confirmation number for each sold hotel segment. If the agent/traveler needs to reconcile the booking with Booking.com, Booking.com requires both the PIN number and confirmation number to locate the segment in their system.
        - `locatorType` string — Specifies the type of reservation ID Travelport - Confirmation number; PNR locator Agency - IATA Number Booking.com - Confirmation number; PIN number In Document History, may return the content source (e.g. GDS or NDC)
        - `source` string — Content source. Typically a two-character Supplier code that indicates the source system which generated the resid. For Hotels, if source matches chain code, the offer is directly with the supplier. If source is 'BO', the offer is with Booking.com.
        - `sourceContext` string — Specifies the context of the source. Either Travelport, Agency, or Supplier.
        - `otaType` string — Used for codes
        - `creationDate` string, date — Date created in Travelport or supplier system in YYYY-MM-DD format.
        - `lastUpdated` string, date-time — The date and time stamp the Reservation was last updated.
      - `supplierLocator` Locator — Locator information for the reservation. Contains the locator (PNR or external locator) or cancellation number for the reservation, order, or offer.
        - `value` string — Reference number for locatorType. Booking.com returns a PIN number along with the confirmation number for each sold hotel segment. If the agent/traveler needs to reconcile the booking with Booking.com, Booking.com requires both the PIN number and confirmation number to locate the segment in their system.
        - `locatorType` string — Specifies the type of reservation ID Travelport - Confirmation number; PNR locator Agency - IATA Number Booking.com - Confirmation number; PIN number In Document History, may return the content source (e.g. GDS or NDC)
        - `source` string — Content source. Typically a two-character Supplier code that indicates the source system which generated the resid. For Hotels, if source matches chain code, the offer is directly with the supplier. If source is 'BO', the offer is with Booking.com.
        - `sourceContext` string — Specifies the context of the source. Either Travelport, Agency, or Supplier.
        - `otaType` string — Used for codes
        - `creationDate` string, date — Date created in Travelport or supplier system in YYYY-MM-DD format.
        - `lastUpdated` string, date-time — The date and time stamp the Reservation was last updated.
      - `orderID` string — The NDC Order ID.
      - `name` string — The name of the traveler the document is issued for
      - `passengerTypeCode` string — Passenger type code
      - `passengerComments` Comments — Comments object to relay free text information In ProductAncillary.Ancillary this is used to expose when additional comments are required to book the ancillary. In BuildAncillaryOffersFromCatalogOfferings this is used to pass additional ancillary text required to book the ancillary. In Traveler this is used to send custom freeform traveler name remarks, such as a unique identifier for a given traveler. Not supported for addition/deletion in Traveler Modify.
        - `@type` string
        - `Comment` Comment[]
          - `value` string — Actual text. May be restricted based on the type of comment. Ex: - Notepad remarks: limited to 87 characters. - Traveler name remarks: limited to 33 characters, only spaces and hyphens allowed for special characters.
          - `id` string — Local identifier within a given message for this object.
          - `name` string — Title of comment or type of remark.
          - `language` string — Language code using ISO-639 standard
      - `pricingDateTimeUTC` string, date — The pricing date and time stamp in UTC.
      - `pricingPseudoCityCode` string — The pseudo city code that the price was created.
      - `platingAirline` string — The plating airline code of the document.
      - `agentEnteredDetails` AgentEnteredDetails — Agency entered details that are submitted at time of pricing or ticketing
        - `fareQuoteModifierString` string[] — Array of modifiers applied at the time of pricing
        - `ticketModifierString` string[] — Array of modifiers applied at the time of ticketing
      - `formOfPayment` FormOfPaymentDocumentHistoryType[] — Array of form of payments related to this document.
        - `formOfPaymentType` string
        - `paymentCard` PaymentCardSimple — Payment Card details.
          - `cardCode` string — The Payment Card Code.
          - `cardNumber` string — The payment card number masked.
          - `cardExpiryDate` string — The payment card expiry date. MMYY format.
          - `cardAuthorizationCode` string — The payment card authorization.
        - `amount` number, float — The total amount charged to this form of payment.
        - `formOfPaymentText` string — Free text information associated to the form of payment.
      - `ticketSegments` TicketSegment[] — Flight information in ticket coupons.
        - `@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
      - `documentDetail` DocumentDetailHistory — Price used on this document
        - `documentPricingDetail` DocumentPricingDetail — Detailed pricing information of the document.
          - `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.
            - `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
          - `filedBaseAmount` CurrencyAmount — A monetary amount, up to 4 decimal places. Decimal place must be included.
            - `value` number, float — The amount of a given currency.
            - `code` string — An ISO 4217 alpha character code (3 characters) that specifies a money unit.
            - `minorUnit` integer — Minor units are a mechanism for expressing the relationship between a major currency unit and its corresponding minor currency unit. It is the smallest unit of a given currency. For example; the smallest denomination in USD is the cent, which is 1/100 of a USD, and the minor unit value is 2. Not all currencies have a minor unit.
            - `currencySource` 'Supplier' | 'Charged' | 'Requested' — The system requesting or returning the currency code specified in the attribute
            - `approximateInd` boolean — If true, the currency amount has been converted from the original amount. For Air Exchange Eligibility, returned only if a currency is converted. If returned, the value is always true, indicating that the fee is approximate because of currency conversion. For Hotel Availability and Rules, true indicates this is a calculated value; false indicates this is the value returned by the property.
          - `base` number, float — The base fare excluding any taxes or fees.
          - `totalTaxes` number, float — Total amount of all taxes.
          - `totalDocumentPrice` number, float — Total of base plus totalTaxes. OB fees are not included in totalDocumentPrice.
          - `totalFees` number, float — Total amount of all fees.
          - `totalChargePrice` number, float — Total of base, totalTaxes and totalFees.
          - `totalAdditionalCollection` number, float — Additional Collection amount charged on the exchanged document.
          - `totalForfeitAmount` number, float — The total amount that has been forfeited after an exchange of documents when a residual amount has not been refunded.
          - `taxBreakdown` Taxes[] — Individual tax breakdown and description.
            - `@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.
              - …
          - `paidTaxBreakdown` Taxes[] — Array of paid 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.
              - …
          - `feeBreakdown` Fee[] — Array of individual fees.
            - `@type` string
            - `feeCode` string — For Hotel, the Hotel provider's explanation of the fee; can be returned either as a code or as text. For Air, the code for the fee, such as 'OB' for OB fees.
            - `reportingAuthority` string — Not used. Identifies the reporting authority.
            - `purpose` string — Not used. Fee purpose
            - `description` string — Any description or text explanation of the charge.
            - `feeApplication` 'PerPerson' | 'PerRoom' | 'PerAccommodation' | 'PerHouse' | 'PerApartment' | 'PerAdult' | 'PerChild' — Application values (such as the application of a fee) like per person or per room.
            - `feeFrequency` 'PerNight' | 'PerDay' | 'PerStay' | 'PerWeek' | 'RoundTrip' | 'OneWay' — The frequency of a fee such as per night or per stay.
            - `FeeAmountOrPercent` FeeAmountOrPercent, required — Defines whether the fee is charged as an amount or percentage.
              - …
            - `Tax` Tax[]
              - …
            - `includedinBaseInd` boolean — If true, indicates the fee is included in Base Price.
            - `includedInTotalPriceInd` boolean — If true, indicates the fee is included in Total Price. Default behavior is for fees not to be included in TotalPrice.
            - `collectionMethod` 'EMD' | 'MCO' | 'Tax' | 'Unknown' — List of change fee method
          - `fareCalculation` FareCalculation — Details on how the fare has been constructed.
            - `fareCalculationString` string — The linear fare calculation string.
            - `rateOfExchange` number, float — The exchange rate applied.
            - `pricingIndicator` string — The pricing code indicates how the fare is priced. e.g. manual or automated. The pricing indicator determines when the fare is valid for the Travelport fare guarantee policy.
          - `commissionAmount` number, float — The amount of commission applied to this document.
          - `commissionPercent` number, float — The percentage of commission override applied to the document.
          - `restrictions` string[] — Array of restrictions/endorsements.
          - `tourCode` string — The tour code applied.
        - `voidDetail` VoidDetail — Detail information on a document that has been voided
          - `voidDocumentNumber` DocumentNumberType — The document number with the type of document
            - `number` string, required — The document number.
            - `numberOfConjunctiveTickets` integer
            - `documentType` 'TKT' | 'EMD' | 'MCO' | 'INV' | 'TASF', required
          - `voidDateTimeUTC` string, date-time — The date time the document was voided in GMT.
          - `source` string
          - `pseudoCityCode` string
          - `voidingAgent` string — The voiding agent initials.
          - `sacCode` string — The settlement authorization code for this transaction
        - `refundDetail` RefundDetail — Detail information on a refunded document
          - `refundDocumentNumber` DocumentNumberType — The document number with the type of document
            - `number` string, required — The document number.
            - `numberOfConjunctiveTickets` integer
            - `documentType` 'TKT' | 'EMD' | 'MCO' | 'INV' | 'TASF', required
          - `refundDateTimeUTC` string, date-time — The date time the document was voided in GMT.
          - `source` string
          - `pseudoCityCode` string
          - `refundingAgent` string — The voiding agent initials.
          - `sacCode` string — The settlement authorization code for this transaction
          - `refundCategory` 'Full' | 'Partial' | 'Automated' | 'NonReportable'
          - `refundAmount` RefundHistoryAmount — Refund amount breakdown
            - `currencyCode` string — 3 letter currency code as defined by ISO-4217.
            - `base` number, float — The base refund amount exclusive of taxes and fees.
            - `equivalent` CurrencyAmount — A monetary amount, up to 4 decimal places. Decimal place must be included.
              - …
            - `totalTaxes` number, float — Total amount of tax refunded.
            - `totalRefund` number, float — Total refund amount.
            - `refundTaxBreakdown` Tax[] — Array of individual taxes.
              - …
            - `cashAmountUsed` number, float — Total cash amount used.
            - `creditAmountUsed` number, float — Total credit amount used.
            - `refundFormOfPayment` FormOfPaymentDocumentHistoryType[] — The form of payment used for the refund including the amount refunded.
              - …
            - `refundPenalty` CurrencyAmount — A monetary amount, up to 4 decimal places. Decimal place must be included.
              - …
            - `refundWaiverCode` WaiverCode — A code assigned by an airline to support waiver of fees or ticket value as a result of disruption to the passenger. Waiver code can be passed during the refund by document process (BuildFromOfferList). Select the type of fee that is to be waivered in the waiver type field. Also passed as a FormOfPayment.
              - …
            - `refundCommissionAmount` number, float — The amount of commission applied to the refunded ticket.
            - `refundCommissionPercent` integer — The percentage of commission override applied to the refunded ticket.
        - `exchangePenalty` CurrencyAmount — A monetary amount, up to 4 decimal places. Decimal place must be included.
          - `value` number, float — The amount of a given currency.
          - `code` string — An ISO 4217 alpha character code (3 characters) that specifies a money unit.
          - `minorUnit` integer — Minor units are a mechanism for expressing the relationship between a major currency unit and its corresponding minor currency unit. It is the smallest unit of a given currency. For example; the smallest denomination in USD is the cent, which is 1/100 of a USD, and the minor unit value is 2. Not all currencies have a minor unit.
          - `currencySource` 'Supplier' | 'Charged' | 'Requested' — The system requesting or returning the currency code specified in the attribute
          - `approximateInd` boolean — If true, the currency amount has been converted from the original amount. For Air Exchange Eligibility, returned only if a currency is converted. If returned, the value is always true, indicating that the fee is approximate because of currency conversion. For Hotel Availability and Rules, true indicates this is a calculated value; false indicates this is the value returned by the property.
        - `residualValue` CurrencyAmount — A monetary amount, up to 4 decimal places. Decimal place must be included.
          - `value` number, float — The amount of a given currency.
          - `code` string — An ISO 4217 alpha character code (3 characters) that specifies a money unit.
          - `minorUnit` integer — Minor units are a mechanism for expressing the relationship between a major currency unit and its corresponding minor currency unit. It is the smallest unit of a given currency. For example; the smallest denomination in USD is the cent, which is 1/100 of a USD, and the minor unit value is 2. Not all currencies have a minor unit.
          - `currencySource` 'Supplier' | 'Charged' | 'Requested' — The system requesting or returning the currency code specified in the attribute
          - `approximateInd` boolean — If true, the currency amount has been converted from the original amount. For Air Exchange Eligibility, returned only if a currency is converted. If returned, the value is always true, indicating that the fee is approximate because of currency conversion. For Hotel Availability and Rules, true indicates this is a calculated value; false indicates this is the value returned by the property.
      - `mcoDetail` MCOInformation — MCO detail information
        - `issuedFor` string — MCO issued for.
        - `reasonForIssuanceCode` string — MCO reason for issuance code.
        - `issuedAt` string — MCO issuance IATA location code.
        - `pTA` 'Yes' | 'No' | 'Unknown' — Yes , No , Unknown
        - `tOD` 'Yes' | 'No' | 'Unknown' — Yes , No , Unknown
        - `comment` string[]
      - `duePaidRemarks` 'Yes' | 'No' | 'Unknown' — Yes , No , Unknown
      - `relatedDocument` DocumentNumberType — The document number with the type of document
        - `number` string, required — The document number.
        - `numberOfConjunctiveTickets` integer
        - `documentType` 'TKT' | 'EMD' | 'MCO' | 'INV' | 'TASF', required
      - `associatedDocument` DocumentNumberType — The document number with the type of document
        - `number` string, required — The document number.
        - `numberOfConjunctiveTickets` integer
        - `documentType` 'TKT' | 'EMD' | 'MCO' | 'INV' | 'TASF', required
      - `exchanges` ExchangeDocumentHistory — Details of documents that have been exchanged for this document.
        - `exchangedFor` PreviousIssue
          - `value` string
          - `issuingCity` string
          - `issueDate` string
          - `agencyCodeIATA` string
          - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice' — Document type like EMD, MCO
        - `originalIssue` PreviousIssue
          - `value` string
          - `issuingCity` string
          - `issueDate` string
          - `agencyCodeIATA` string
          - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice' — Document type like EMD, MCO
        - `previousIssue` PreviousIssue[] — Array of previous issued documents.
          - `value` string
          - `issuingCity` string
          - `issueDate` string
          - `agencyCodeIATA` string
          - `documentType` 'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice' — Document type like EMD, MCO
    - `@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/2628253a4cd5/schema)
