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

Sample Request:

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

---

Request Constraints & Business Rules

• bookingCode must be a valid, active booking.
• bookingCode must be provided with the selected baggage values.
• baggageValue must be obtained from the corresponding Get Baggages response for the same booking/flight context.
• 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

---

Sample Response

{
  "system": "VN",
  "status": true,
  "error": null,
  "description": null,
  "trackingId": "def456",
  "trackingTime": "2025-07-01T07:10:00.000Z"
}

---

Error Codes

This endpoint may return the following error codes:

• 21000 - Baggage: Errors specific to baggage operations (21000-21004)
• 00000 - Flight Hub (General Errors): General system and authentication errors (00001-00056)

For a complete list of error codes, see Error Codes.

---

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.