Get System List

Retrieve the list of active airline ticketing systems configured and authorized for the authenticated user group.

---

Endpoint

• URL: /api/v1/system
• Method: GET
• 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

This is a GET endpoint and does not require any request body parameters.

Query Parameters

Field	Type	Required	Description
isNDC	boolean	No	Filter systems by NDC support. Use true for NDC-capable systems, false for non-NDC systems, or omit to return all authorized systems.

Sample Request

GET /api/v1/system?isNDC=true HTTP/1.1
Host: flight-api-hub-dev.tripota.com.vn
Authorization: Bearer <access_token>
X-API-KEY: <api_key>

---

Response Structure

Returns an array of system representation objects:

Field	Type	Nullable	Description
code	string	Yes	Unique system identifier code (e.g. VN, VJ, 1A)
name	string	Yes	Readable name of the airline system (e.g. Vietnam Airlines, Vietjet Air, Amadeus)

Sample Response:

[
  {
    "code": "VN",
    "name": "Vietnam Airlines"
  },
  {
    "code": "VJ",
    "name": "Vietjet Air"
  },
  {
    "code": "1A",
    "name": "Amadeus GDS"
  },
  {
    "code": "PR",
    "name": "Philippine Airlines"
  },
  {
    "code": "9C",
    "name": "Spring Airlines"
  }
]

---

Error Codes

This endpoint may return the following error codes:

• 00000 - Flight Hub (General Errors): General system and authentication errors (00001-00056)

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

---

Security & Validation

• Only authenticated users with valid sessions/tokens can retrieve system lists.
• Returns only systems that the user's partner code is authorized to access.
• Access to the endpoint is logged for audit purposes.

---

Validation Questions

• How are systems mapped to sign-in groups/partners?
• Is there any caching policy applied to the system list response?

---

For integration support, see Contact Support.