Add Remark Ticket

Add one or more remarks to specific tickets in a flight booking system.

---

Endpoint

• URL: /api/v1/flight/add-remark-ticket
• 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)
tickets	array of string	No	List of ticket numbers to add remarks to
remarks	array of string	No	List of remark texts to add

Sample Request:

{
  "system": "VN",
  "tickets": [
    "2389876543210"
  ],
  "remarks": [
    "NON-ENDORSABLE CORP DISP",
    "PAX SPECIAL SERVICE MEAL ASSIGNED"
  ]
}

---

Request Constraints & Business Rules

• Ticket numbers must be valid and exist in the specified booking system.
• Remarks are appended to the ticket history or notes and must comply with system character limits.

---

Response Structure

Field	Type	Nullable	Description
system	string	Yes	System name (e.g., VN, VJ, 1A)
status	boolean	No	true if successful, false if failed
error	object	Yes	Error details (if any)
description	string	Yes	Error description (if any)
trackingId	string	Yes	Tracking ID for request logs
trackingTime	string	Yes	Time for request tracking (ISO 8601 format)

Sample Response:

{
  "system": "VN",
  "status": true,
  "error": null,
  "description": "Remarks added successfully to tickets",
  "trackingId": "track-rem456",
  "trackingTime": "2024-06-01T12:00:00Z"
}

---

Error Codes

This endpoint may return the following error codes:

• 28000 - Remark: Remark-specific errors (28001)
• 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.
• All actions are logged and traceable.

---

Validation Questions

• Can remarks be added to tickets that are already voided or refunded?
• Is there a maximum length or character restriction for remark content?

---

For integration support, see Contact Support.