Additional baggage

You add baggage after selecting a flight offer. Baggage options are specific to an offer, passenger, and flight segment.

Retrieve baggage options

Request the latest offer with baggage options:

GET /v1/air/offers/{offerId}?include_additional_baggage=true

The response contains additionalBaggageOptions. Each option provides its price, maximum quantity, eligible passengers, and eligible segments.

{
  "additionalBaggageOptions": [
    {
      "optionId": "bag_option_...",
      "maximumQuantity": 2,
      "passengerIds": ["psg_1"],
      "segmentIds": ["seg_1"],
      "unitPrice": {
        "amount": "25.00",
        "amountCents": 2500,
        "currency": "USD"
      }
    }
  ]
}

Not every offer supports additional baggage. An empty array means no baggage options are currently available.

Select more than one bag

Use quantity to request multiple bags from one option. The quantity cannot exceed maximumQuantity.

{
  "additionalBaggage": [
    {
      "optionId": "bag_option_...",
      "quantity": 2
    }
  ]
}

You can also select different options for different passengers or segments.

{
  "additionalBaggage": [
    {
      "optionId": "bag_option_for_passenger_1",
      "quantity": 2
    },
    {
      "optionId": "bag_option_for_passenger_2",
      "quantity": 1
    }
  ]
}

Create the order

Pass additionalBaggage to POST /v1/air/orders with the selected offer and passenger details. The order total, wallet debit, payment, and ticketing amount include the selected baggage. Order responses and webhooks return the selections as additionalBaggage.

Retrieve the offer again immediately before creating the order. The API rejects unavailable options, duplicate option IDs, and quantities above the allowed maximum.

Location

Search

Orders

Financial

Platform

Additional baggage

Additional baggage

Retrieve baggage options

Select more than one bag

Create the order

​Additional baggage

​Retrieve baggage options

​Select more than one bag

​Create the order

Additional baggage

Retrieve baggage options

Select more than one bag

Create the order