OfferPrice

Overview

The OfferPrice API is used to verify the actual price and detailed fare conditions of a selected Offer retrieved from the AirShopping step.
The airline returns information including the total fare amount, fare class details, baggage allowance, and fare rules.

Usage Guidelines

FFN (Loyalty program)

Supported: AF, KL

Additional Baggage Purchase

When purchasing additional baggage, call ServiceList first, then proceed with OfferPrice.

In OfferPriceRQ/Query/Offers{1…*}, include as many baggage service Offers as needed.

If the value of ServiceListRS/AlaCarteOffer/AlaCarteOfferItem/Service/ServiceCode is "XBAG",
you must specify the baggage weight in BookingInstructions/Text (e.g., TTL10KG).

For "BULK", "PIEC", or "HEAV" codes, no BookingInstructions input is required.

Additional Seat Selection Purchase

When purchasing or confirming seat selections, call SeatAvailability first to retrieve seat map offers, then proceed with OfferPrice.

In OfferPriceRQ/Query/Offers{1…*}, include the selected seat service Offers.

Use the information from SeatAvailabilityRS/ALaCarteOffer/SeatMap/Layout to populate seat details.

Each OfferItem must contain a SeatSelection object specifying the chosen seat:
Column: seat column (e.g., "G")
Row: seat row number (e.g., "20")

MatchResult behavior for RT / MT Offers

MatchResult and how it affects OfferPriceRQ selection

For Round Trip (RT) and Multi Trip (MT) shopping flows, AirShoppingRS/Offer/MatchResult indicates whether the airline returned pricing as a single combined Offer or as separate Offers per journey.

MatchResult = FULL

The airline provides a single Offer that already covers all journeys in the search request.

You can proceed with OfferPrice using exactly one Offer (select 1 OfferID and its OfferItems).

MatchResult = PARTIAL

The airline provides separate Offers, each matching only part of the itinerary (typically one journey / one origin-destination).

To price the full itinerary, you must include multiple Offers in OfferPriceRQ, selecting as many Offers as the number of journeys (ODs) in the request.

Example: For an ICN–LHR round trip, if the response is PARTIAL, you typically need to select 2 Offers (one for outbound and one for return). If the response is FULL, select 1 Offer only.

Upsell

OfferPrice supports retrieving additional upsell offers based on the selected Offer.

In OfferPriceRQ/Query/ResponseParameter/PricingParameter/IncludeUpsellOffersInd, the value must be set to true.

To select an upsell offer, choose one from OfferPriceRS/OtherOffers.

Not supported : AS, EK, HA, TR

TK supports upsell offers only under a specific Offer Flow configuration.
Please contact us separately to enable upsell support.

For LH and AA, upsell offers are returned with MatchResult = PARTIAL, but the actual offer status is MatchResult = FULL (MatchResult = PARTIAL is an airline-side error).

application/json

Body

Example

{
    "ResultMessage": {
        "Code": "00000",
        "Message": "SUCCESS",
        "MessageDetail": {
            "Errors": [],
            "Warnings": []
        }
    },
    "Recipient": {
        "TravelAgency": {
            "AgencyID": "TSDV001",
            "SiteCode": "01",
            "ContactInfoRefID": []
        }
    },
    "PointOfSale": "KR",
    "TransactionID": "d444699d5cec4de5b04da94557b3bbcc",
    "PricedOffer": {
        "ResponseID": "d444699d5cec4de5b04da94557b3bbcc",
        "OfferID": "47b196ddee1b44e29570fbd95cc01f3e17.2-1",
        "Owner": "LH",
        "TotalPrice": {
            "TotalAmount": {
                "Amount": 3303000,
                "CurCode": "KRW"
            },
            "TravelAgencyServiceFee": [],
            "TotalBaseAmount": {
                "Amount": 451000,
                "CurCode": "KRW"
            },
            "TotalTaxAmount": {
                "Amount": 2852000.0,
                "CurCode": "KRW"
            },
            "FopPromotion": []
        },
        "OfferTimeLimit": "2026-03-25T09:42:51Z",
        "JourneyOverview": [
            {
                "PaxJourneyRefID": "Pflts5k5qsrofbspr",
                "PriceClassInfo": {
                    "PriceClass": "Ppcqu6syvh95xw0u",
                    "Code": "ESV00",
                    "Name": "Economy Basic Plus",
                    "Descriptions": [
                        {
                            "Text": "Food and Beverages"
                        },
                        {
                            "Text": "1 Hand Baggage"
                        },
                        {
                            "Text": "Checked Baggage Included"
                        },
                        {
                            "Text": "Warning: all services may not be delivered as the requested itinerary may include flights operated by our partner airlines"
                        }
                    ]
                }
            },
            {
                "PaxJourneyRefID": "Pflt3jo4p59osedgs",
                "PriceClassInfo": {
                    "PriceClass": "Ppcqu6syvh95xw0u",
                    "Code": "ESV00",
                    "Name": "Economy Basic Plus",
                    "Descriptions": [
                        {
                            "Text": "Food and Beverages"
                        },
                        {
                            "Text": "1 Hand Baggage"
                        },
                        {
                            "Text": "Checked Baggage Included"
                        },
                        {
                            "Text": "Warning: all services may not be delivered as the requested itinerary may include flights operated by our partner airlines"
                        }
                    ]
                }
            }
        ],
        "MatchResult": "Full",
        "BaggageAllowance": [
            {
                "PaxJourneyRefID": "Pflts5k5qsrofbspr",
                "PaxRefID": [
                    "T1",
                    "T2",
                    "T3",
                    "T1.1"
                ],
                "TypeCode": "Checked",
                "Desc": [
                    "CHECKED ALLOWANCE"
                ],
                "PieceAllowance": "1",
                "MaximumWeightAllowance": {
                    "Value": 23.0,
                    "UnitCode": "KG"
                }
            },
            {
                "PaxJourneyRefID": "Pflts5k5qsrofbspr",
                "PaxRefID": [
                    "T1",
                    "T1",
                    "T2",
                    "T2",
                    "T3",
                    "T3"
                ],
                "TypeCode": "CarryOn",
                "Desc": [
                    "CARRYON HAND BAGGAGE ALLOWANCE",
                    "CARRY8KG 18LB UPTO46LI 118LCM"
                ],
                "PieceAllowance": "1",
                "MaximumWeightAllowance": {
                    "Value": 8.0,
                    "UnitCode": "KG"
                }
            },
            {
                "PaxJourneyRefID": "Pflt3jo4p59osedgs",
                "PaxRefID": [
                    "T1",
                    "T2",
                    "T3",
                    "T1.1"
                ],
                "TypeCode": "Checked",
                "Desc": [
                    "CHECKED ALLOWANCE"
                ],
                "PieceAllowance": "1",
                "MaximumWeightAllowance": {
                    "Value": 23.0,
                    "UnitCode": "KG"
                }
            },
            {
                "PaxJourneyRefID": "Pflt3jo4p59osedgs",
                "PaxRefID": [
                    "T1",
                    "T1",
                    "T2",
                    "T2",
                    "T3",
                    "T3"
                ],
                "TypeCode": "CarryOn",

Overview

Usage Guidelines

FFN (Loyalty program)

Additional Baggage Purchase

Additional Seat Selection Purchase

MatchResult behavior for RT / MT Offers

MatchResult and how it affects OfferPriceRQ selection

Upsell

Request

Request Code Samples

Responses

OfferPrice

Overview#

Usage Guidelines#

FFN (Loyalty program)#

Additional Baggage Purchase#

Additional Seat Selection Purchase#

MatchResult behavior for RT / MT Offers#

MatchResult and how it affects OfferPriceRQ selection#

Upsell#

Request

Request Code Samples

Responses

Overview

Usage Guidelines

FFN (Loyalty program)

Additional Baggage Purchase

Additional Seat Selection Purchase

MatchResult behavior for RT / MT Offers

MatchResult and how it affects OfferPriceRQ selection

Upsell