---
title: "Get flight checkout details"
method: POST
path: "/v2/air/flight-checkout"
tags: ["Air"]
---

# Get flight checkout details

`POST /v2/air/flight-checkout`

Get the flight checkout details associated with the selected itinerary.

## Request body

- AirCheckoutRequest — Describes the itinerary selected by the user for checkout.
  - `searchId` string, required — Search id returned in the corresponding air search API response.
  - `itineraryId` string, required — Value of the itineraryId for the itinerary selected by the user in the corresponding air search API response.

## Response `200`

OK

- AirCheckoutResponse — Describes the air ancillaries and checkout options available for selection for the chosen itinerary.
  - `checkoutResponseId` string, required — The unique ID which identifies this checkout response. This value must passed on in the subsequent booking API calls.
  - `baggageInfo` BaggageSelectionInfo — Describes the baggage selection options available for the user to buy on the flight checkout page.
    - `baggageSelectionGroups` BaggageSelectionGroup[]
      - `travelerApplicability` TravelerApplicability
        - `applicability` 'PER_TRAVELER' | 'ALL_TRAVELERS', required
      - `legApplicability` LegApplicability — Describes the leg level applicability and the leg association.
        - `applicability` 'PER_LEG' | 'ALL_LEGS', required
        - `legId` string — Identifier for the leg. Present when applicability is PER_LEG.
      - `travelerBaggageOptions` TravelerBaggageOptions[]
        - `travelerType` 'UNKNOWN_PASSENGER_TYPE' | 'ADULT' | 'CHILD' | 'INFANT' | 'INFANT_ON_LAP' | 'YOUTH' | 'SENIOR' | 'TEEN' — Type of passenger
        - `travelerAge` PassengerAge — Age of the traveler
          - `numYears` integer, required — Age of the passenger
        - `baggageOptions` union — Describes a group of baggage options from which the user can select one or more.
          - object — Describes the baggage option group which provides the users with multiple options to choose one from. Example options: (1) 1 bag for $20 for 20kg (2) 2 bags for 30kg worth $50 (3) 3 bags 10+20+30kg worth 100$ $(20+30+50).
            - `singleSelectOptions` ComplexBagOption[], required
              - …
          - object — Describes the baggage option group which provides the users with multiple baggage options. Users can select one or more of them. For example: (1) 1st 20kg bag for $20 (2) 2nd 20kg bag for $30 (3) 3rd bag of 40kg for $40
            - `multiSelectOptions` SimpleBagOption[], required — A list of baggage options that may be selected.
              - …
  - `ancillaries` AncillarySelectionInfo[] — List of ancillaries available for purchase.
    - `type` 'EARLY_BIRD' | 'WIFI' | 'CARBON_OFFSET', required — Type of ancillary
    - `displayName` string, required — Display name for this ancillary type
    - `description` string, required — Description for this ancillary type
    - `ancillaryOptions` AncillaryOption[], required — Ancillary options for this ancillary type
      - `travelerId` UserId — User identifier
        - `id` string, uuid, required
      - `status` 'ELIGIBLE' | 'NOT_APPLICABLE' | 'PURCHASED', required — Ancillary status (purchased, eligible for purchase, not applicable, etc.).
      - `fare` Money, required — Money object containing details such as the amount, the currency code, and the converted amount.
        - `amount` number, double, required — The numeric value for the amount of money.
        - `currencyCode` string, required — The 3-letter currency code for the money amount (defined using ISO 4217 standard).
        - `convertedAmount` number, double — The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
        - `convertedCurrency` string — The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
        - `otherCoinage` object[] — List of the dollar amount in other coinage systems like reward points, cryptocurrency etc.
          - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' — Payment method
          - `amount` number, double
          - `conversionRate` number, double — 1 coin in this system equals to how many currency value
          - `preferredCurrencyConversionRate` number, double — 1 coin in this system equals to how many currency value
          - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper — Wrapper for Flight Pass payment metadata.
            - `metadataType` string — Discriminator field for polymorphic deserialization
            - `flightPassMetadata` FlightPassPaymentMetadata, required — Metadata specific to Flight Pass payment method in OtherCoinage.
              - …
      - `flightIds` string[], required — ID of the flights on which this ancillary applies.
      - `ancillaryId` string, required — Unique ID for purchasing this ancillary.
  - `mandatoryCheckoutParams` MandatoryParamForCheckout[]
    - `travelerApplicability` TravelerApplicability, required
      - `applicability` 'PER_TRAVELER' | 'ALL_TRAVELERS', required
    - `parameter` 'DATE_OF_BIRTH' | 'BILLING_ADDRESS' | 'POSTAL_CODE' | 'CVV' | 'PASSPORT_ID' | 'PASSPORT_EXPIRY_DATE' | 'PASSPORT_ISSUE_COUNTRY' | 'NATIONALITY' | 'GENDER' | 'CVV_ON_PERSONAL_CARD' | 'TITLE' — The mandatory parameter to be collected.
  - `airlineCardFees` AirlineCardFee[] — List of all the supported card options. If this list is empty, all cards are supported.
    - `type` 'CREDIT' | 'DEBIT', required
    - `company` 'NONE' | 'VISA' | 'MASTERCARD' | 'AMEX' | 'DISCOVER' | 'AIR_TRAVEL_UATP' | 'CARTE_BLANCHE' | 'DINERS_CLUB' | 'JCB' | 'BREX' | 'UNION_PAY' | 'EURO_CARD' | 'ACCESS_CARD' | 'ELO_CARD', required — The issuing company of card
    - `fees` Money — Money object containing details such as the amount, the currency code, and the converted amount.
      - `amount` number, double, required — The numeric value for the amount of money.
      - `currencyCode` string, required — The 3-letter currency code for the money amount (defined using ISO 4217 standard).
      - `convertedAmount` number, double — The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).
      - `convertedCurrency` string — The 3-letter currency code for the converted currency (defined using ISO 4217 standard).
      - `otherCoinage` object[] — List of the dollar amount in other coinage systems like reward points, cryptocurrency etc.
        - `coinageCode` 'PAYMENT_METHOD_UNKNOWN' | 'CREDIT_CARD' | 'BREX_POINTS' | 'CASH' | 'QANTAS_POINTS' | 'VENDOR_PROGRAM_PAYMENT' | 'DELAYED_INVOICING' | 'FLIGHT_CREDITS' | 'QANTAS_TRAVEL_FUND' | 'CUSTOM_VIRTUAL_PAYMENT' | 'FLIGHT_PASS' | 'MISCELLANEOUS_CREDIT_ORDER' | 'NO_PREPAYMENT' — Payment method
        - `amount` number, double
        - `conversionRate` number, double — 1 coin in this system equals to how many currency value
        - `preferredCurrencyConversionRate` number, double — 1 coin in this system equals to how many currency value
        - `otherCoinageMetadata` FlightPassPaymentMetadataWrapper — Wrapper for Flight Pass payment metadata.
          - `metadataType` string — Discriminator field for polymorphic deserialization
          - `flightPassMetadata` FlightPassPaymentMetadata, required — Metadata specific to Flight Pass payment method in OtherCoinage.
            - `flightPassNumber` string — Flight pass number
            - `flightPassAmounts` FlightPassPaymentAmounts — Fare breakdown for the flight pass booking.
              - …

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found.

---

[API](https://skmtc.net/spotnana/apis/air-api.md) · [All operations](https://skmtc.net/spotnana/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/air-api/revisions/4dd80446ce32/schema)
