Add Baggage

Add one or more baggage options to an existing booking.

---

Endpoint

• URL: /api/v1/flight/addbaggage
• Method: POST
• Auth Required: Yes (Bearer Token/X-api-key)
• Content-Type: application/json

---

Authentication

This endpoint requires a valid JWT Bearer token in the Authorization header:

Authorization: Bearer <access_token>

Obtain tokens via /api/v1/sign-in (POST) with your credentials.

---

Request Structure

Field	Type	Required	Description
system	string	Yes	Booking system code (e.g., VN, VJ, 1A)
bookingCode	string	Yes	Booking code (PNR)
baggages	array	Yes	List of baggage objects to add (see below)

Baggage Object (BaggageInfo)

Field	Type	Required	Description
quantity	integer	Yes	Number of baggage items to add
baggageValue	string	Yes	Encoded baggage value from Get Baggages

Example Request:

{
  "system": "VN",
  "bookingCode": "ABC123",
  "baggages": [
    { 
      "quantity": 1,
      "baggageValue": "eyJ2YWx1ZSI6ICJCRzI1IiwgInByaWNlIjogNDAwMDAwfQ==" 
    }
  ]
}

---

Request Constraints & Business Rules

• bookingCode must be a valid, active booking.
• baggageValue must be obtained from a previous Get Baggages response.
• quantity must be a positive integer indicating the number of baggage items to add.
• Only available for bookings that allow baggage modification.

---

Response Structure

Field	Type	Nullable	Description
system	string	Yes	Name of the airline system
status	boolean	No	true if successful, false if failed
error	ErrorCode (object)	Yes	Error details (if any)
description	string	Yes	Error description (if any)
trackingId	string	Yes	Tracking ID for request logs
trackingTime	string (date-time)	Yes	Time for request tracking
baggages	array of Baggage	Yes	List of added baggage options

---

Example Response

{
  "system": "VN",
  "status": true,
  "error": null,
  "description": null,
  "trackingId": "def456",
  "trackingTime": "2025-07-01T07:10:00.000Z",
  "baggages": [
    {
      "code": "BG25",
      "name": "25kg Baggage",
      "route": "HANSGN",
      "prices": [
        {
          "passengerType": "ADT",
          "price": 400000,
          "currency": "VND",
          "value": "eyJ2YWx1ZSI6ICJCRzI1IiwgInByaWNlIjogNDAwMDAwfQ=="
        }
      ]
    }
  ]
}

---

Error Codes

See Error Codes for details on possible error responses.

---

Security & Validation

• All input is validated for type and required fields.
• Only authenticated users can access this endpoint.
• The endpoint is protected against tampering with bookingCode and baggageValue.

---

Validation Questions

• Are there limits on the number of baggage items that can be added per booking?
• Can baggage be added after check-in or only before?
• Are there airline-specific restrictions on baggage types or weights?

---

For integration support, see Contact Support.