Search for a one-way flight Vietjet.

# 1. Tổng quan

Action URL: /api/v1/vj/flight/search
Đặc tả chi tiết: Swagger UI (opens new window)
Chức năng: Tìm kiếm chuyến bay một chiều của Vietjet Air.
Điều kiện sử dụng: Chỉ áp dụng cho tài khoản có quyền truy cập hợp lệ.

# 2. Hướng dẫn sử dụng API

# Các bước thực hiện

Bước 1: Xây dựng request với đầy đủ header và body.
Bước 2: Gửi request POST tới Action URL.
Bước 3: Nhận về response chứa danh sách các chuyến bay một chiều tương ứng với thông tin tìm kiếm.

# 3. Request

# 3.1 Ví dụ Request Body

{
  "origin": "HAN",
  "destination": "SGN",
  "departDate": "2025-11-09",
  "adults": 1,
  "children": 0,
  "infants": 0,
  "cabinClass": "Y"
}

# 3.2 Cấu trúc dữ liệu Request

Thuộc tính	Bắt buộc	Kiểu dữ liệu	Mô tả	Ví dụ
origin	Có	String	Sân bay khởi hành (mã IATA)	HAN
destination	Có	String	Sân bay đến (mã IATA)	SGN
departureDate	Có	String	Ngày khởi hành	2025-11-09
adultCount	Có	Number	Số lượng người lớn	1
childCount	Không	Number	Số lượng trẻ em	0
infantCount	Không	Number	Số lượng em bé	0
cabinClass	Có	String	Hạng ghế	Y
currency	Có	String	Loại tiền tệ hiển thị	VND

# 4. Response

# 4.1 Ví dụ

{
  "statusCode": 200,
  "timestamp": "2025-10-22T09:22:43.516Z",
  "path": "/api/v1/vj/flight/search",
  "message": "Tìm kiếm chuyến bay Vietjet thành công",
  "data": {
    "success": true,
    "message": "Found 3 flight options",
    "flight_options": [
      {
        "key": "oqK13ZVMX9j8xAixVZ0gYuHos2js6a8s9cz¥eomH8WTN757rEmO¥4zkClwwTMDgq8pbwNb5S9N9 ...",
        "cityPair": "HAN-SGN",
        "departureDate": "2025-11-09",
        "enRouteHours": 2.1667,
        "numberOfStops": 1,
        "numberOfChanges": 0,
        "flights": [
          {
            "key": "PPqvYGw83Xp¥7VtFay¥QwL4YTSPHT0w9jSK7mujB7b8=",
            "airlineCode": "VJ",
            "flightNumber": "121",
            "aircraftModel": "321",
            "departure": {
              "scheduledTime": "2025-11-08 23:00:00Z",
              "localScheduledTime": "2025-11-09 06:00:00",
              "airport": "HAN",
              "airportName": "Ha Noi",
              "terminal": null
            },
            "arrival": {
              "scheduledTime": "2025-11-09 01:10:00Z",
              "localScheduledTime": "2025-11-09 08:10:00",
              "airport": "SGN",
              "airportName": "Ho Chi Minh",
              "terminal": "T1"
            },
            "availability": 77,
            "infantAvailability": 23
          }
        ],
        "fareOptions": [
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrUA7b3WzWejQrT¥Wvf4dvuZT¥NZpAV77JfCfDWQ61jM8tYfib6ck ...",
            "fareClass": "Z1_ECO",
            "fareDescription": "Eco1",
            "bookingCode": "Z",
            "cabinClass": "Economy",
            "fareType": "Eco",
            "availability": 20,
            "cheapestFareType": true,
            "cheapestFareOption": true,
            "totalPrice": 922400,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "Z1_ECO",
                "amount": 922400,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Seat Assignment",
                "amount": 101,
                "currency": "VND",
                "chargeType": "Seat Assignment"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          },
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrUA7b3WzWejQrT¥Wvf4dvuZT¥NZpAV77JfCfDWQ61jM8tYfib6ckƒGƒAe5 ...",
            "fareClass": "Z1_DLX",
            "fareDescription": "Deluxe1",
            "bookingCode": "Z",
            "cabinClass": "Economy",
            "fareType": "Deluxe",
            "availability": 20,
            "cheapestFareType": true,
            "cheapestFareOption": false,
            "totalPrice": 1738800,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "Z1_DLX",
                "amount": 1738800,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          },
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrdphLZaO3CmGDWvRJbuzQRWi9nNjuZrkI0j8g6wIi2ƒw3 ... ",
            "fareClass": "V_SBoss",
            "fareDescription": "SkyBoss",
            "bookingCode": "V",
            "cabinClass": "Economy",
            "fareType": "SkyBoss",
            "availability": 12,
           
 "cheapestFareType": true,
            "cheapestFareOption": false,
            "totalPrice": 3488400,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "V_SBoss",
                "amount": 3488400,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          }
        ]
      },
      {
        "key": "oqK13ZVMX9j8xAixVZ0gYuHos2js6a8s9cz¥eomH8WTN757rEmO¥4zkClwwTMDgq8pbwNb5S9N9 ...",
        "cityPair": "HAN-SGN",
        "departureDate": "2025-11-09",
        "enRouteHours": 2.1667,
        "numberOfStops": 1,
        "numberOfChanges": 0,
        "flights": [
          {
            "key": "PPqvYGw83Xp¥7VtFay¥QwETh7cDkc7VWhMIGjbx61CM=",
            "airlineCode": "VJ",
            "flightNumber": "125",
            "aircraftModel": "320",
            "departure": {
              "scheduledTime": "2025-11-09 00:55:00Z",
              "localScheduledTime": "2025-11-09 07:55:00",
              "airport": "HAN",
              "airportName": "Ha Noi",
              "terminal": null
            },
            "arrival": {
              "scheduledTime": "2025-11-09 03:05:00Z",
              "localScheduledTime": "2025-11-09 10:05:00",
              "airport": "SGN",
              "airportName": "Ho Chi Minh",
              "terminal": "T1"
            },
            "availability": 164,
            "infantAvailability": 18
          }
        ],
        "fareOptions": [
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrUkƒXIPVN3KMoclPKSGIEvyERW4IzihPyR3PBivnIXbI3xQrqC6Un ...",
            "fareClass": "E1_ECO",
            "fareDescription": "Eco1",
            "bookingCode": "E",
            "cabinClass": "Economy",
            "fareType": "Eco",
            "availability": 92,
            "cheapestFareType": true,
            "cheapestFareOption": true,
            "totalPrice": 455800,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "E1_ECO",
                "amount": 455800,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          },
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrUkƒXIPVN3KMoclPKSGIEvyERW4IzihPyR3PBivnIXbI3xQr ...",
            "fareClass": "E1_DLX",
            "fareDescription": "Deluxe1",
            "bookingCode": "E",
            "cabinClass": "Economy",
            "fareType": "Deluxe",
            "availability": 92,
            "cheapestFareType": true,
            "cheapestFareOption": false,
            "totalPrice": 1272300,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "E1_DLX",
                "amount": 1272300,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          },
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrRBscƒRPwK7UGe8mwLlk9mRrGpCzIZj767Y0pJGR1r8HG3a5gpPgGyBgQ ...",
            "fareClass": "V_SBoss",
            "fareDescription": "SkyBoss",
            "bookingCode": "V",
            "cabinClass": "Economy",
            "fareType": "SkyBoss",
            "availability": 12,
            "cheapestFareType": true,
            "cheapestFareOption": false,
            "totalPrice": 3488400,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "V_SBoss",
                "amount": 3488400,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          }
        ]
      },
      {
        "key": "oqK13ZVMX9j8xAixVZ0gYuHos2js6a8s9cz¥eomH8WTN757rEmO¥4zkClwwTMDgq8pbwNb5S9N9 ...",
        "cityPair": "HAN-SGN",
        "departureDate": "2025-11-09",
        "enRouteHours": 1.3333,
        "numberOfStops": 1,
        "numberOfChanges": 0,
        "flights": [
          {
            "key": "ONTKH6VTslvMLxHzQNd5Y3oyluW¥JNH9AxrsƒMF7MQ8=",
            "airlineCode": "VJ",
            "flightNumber": "185",
            "aircraftModel": "330",
            "departure": {
              "scheduledTime": "2025-11-09 05:40:00Z",
              "localScheduledTime": "2025-11-09 12:40:00",
              "airport": "HAN",
              "airportName": "Ha Noi",
              "terminal": null
            },
            "arrival": {
              "scheduledTime": "2025-11-09 07:00:00Z",
              "localScheduledTime": "2025-11-09 14:00:00",
              "airport": "SGN",
              "airportName": "Ho Chi Minh",
              "terminal": null
            },
            "availability": 365,
            "infantAvailability": 33
          }
        ],
        "fareOptions": [
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrUkT¥CxgGB¥Mwy6r1XIw9¥xrvbhrb¥iNHQ5¥y6VX4N ...",
            "fareClass": "S1_ECO",
            "fareDescription": "Eco1",
            "bookingCode": "S",
            "cabinClass": "Economy",
            "fareType": "Eco",
            "availability": 16,
            "cheapestFareType": true,
            "cheapestFareOption": true,
            "totalPrice": 3267000,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "S1_ECO",
                "amount": 3267000,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Seat Assignment",
                "amount": 32400,
                "currency": "VND",
                "chargeType": "Seat Assignment"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          },
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTrUkT¥CxgGB¥Mwy6r1XIw9¥xrvbhrb¥iNHQ5¥y6VX4Ni ...",
            "fareClass": "S1_DLX",
            "fareDescription": "Deluxe1",
            "bookingCode": "S",
            "cabinClass": "Economy",
            "fareType": "Deluxe",
            "availability": 16,
            "cheapestFareType": true,
            "cheapestFareOption": false,
            "totalPrice": 3534900,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "S1_DLX",
                "amount": 3534900,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          },
          {
            "bookingKey": "nlBxOkrƒeWPjoL8DOWVTra7CW¥59GHvLaAvWo¥¥L23LX3FnwtiaCpPBRDMZlwyN ...",
            "fareClass": "V_SBoss",
            "fareDescription": "SkyBoss",
            "bookingCode": "V",
            "cabinClass": "Economy",
            "fareType": "SkyBoss",
            "availability": 18,
            "cheapestFareType": true,
            "cheapestFareOption": false,
            "totalPrice": 3488400,
            "currency": "VND",
            "fareCharges": [
              {
                "description": "V_SBoss",
                "amount": 3488400,
                "currency": "VND",
                "chargeType": "Fare"
              },
              {
                "description": "Airport Security",
                "amount": 21700,
                "currency": "VND",
                "chargeType": "Airport Security Scan"
              },
              {
                "description": "Airport Tax Domestic",
                "amount": 107000,
                "currency": "VND",
                "chargeType": "Airport Improvement Fund"
              },
              {
                "description": "Admin Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Admin Fee"
              },
              {
                "description": "Management Fee Domestic",
                "amount": 250900,
                "currency": "VND",
                "chargeType": "Management Fee"
              }
            ]
          }
        ]
      }
    ],
    "total_options": 3
  },
  "errors": null
}

# 4.2 Cấu trúc dữ liệu Response

# Thuộc tính API Tìm kiếm chuyến bay Vietjet

# Thuộc tính

Thuộc tính	Bắt buộc	Kiểu dữ liệu	Mô tả
StatusCode	Có	String	Tình trạng tạo sub
Timestamp	Có	String	Thời gian xử lý request
Path	Có	String
Message	Có	String	Thông báo kết quả
Errors	Không	String	Thông tin lỗi nếu có
RequestId	Có	String	Mã định danh request
TotalDuration	Có	string	Thời gian xử lý (ms)
success	Có	Boolean	Thành công hay không
message	Có	String	Mô tả thêm
flight_options	Có	Array	Danh sách chuyến bay
key	Có	String	Mã định danh chuyến bay
cityPair	Có	String	Hành trình
departureDate	Có	String	Ngày khởi hành
enRouteHours	Có	Number	Tổng thời gian bay
numberOfStops	Có	Number	Số điểm dừng
numberOfChanges	Có	Number	Số lần đổi chuyển
flights	Có	Array	Thông tin các chặng bay
fareOptions	Có	Array	Các loại giá vé
airlineCode	Có	String	Mã hãng bay
flightNumber	Có	String	Số hiệu chuyến bay
aircraftModel	Có	String	Loại máy bay
departure	Có	Object	Thông tin điểm đi
arrival	Có	Object	Thông tin điểm đến
availability	Có	Number	Số ghế còn trống
infantAvailability	Có	Number	Số ghế cho trẻ sơ sinh
scheduledTime	Có	String	Giờ theo UTC
localScheduledTime	Có	String	Giờ địa phương
airport	Có	String	Mã sân bay
airportName	Có	String	Tên sân bay
terminal	Có	String	Nhà ga
bookingKey	Có	String	Mã booking mã hóa
fareClass	Có	String	Hạng giá chi tiết
fareDescription	Có	String	Mô tả loại giá
bookingCode	Có	String	Mã đặt chỗ
cabinClass	Có	String	Hạng ghế
fareType	Có	String	Loại vé
availability	Có	Number	Số ghế khả dụng
totalPrice	Có	Number	Tổng giá vé
currency	Có	String	Đơn vị tiền tệ
fareCharges	Có	Array	Chi tiết phí

# Bảng mô tả mã tình trạng tạo sub

Mã	Ý nghĩa
200	Thành công
400	Dữ liệu không hợp lệ
401	Không có quyền tạo sub
404	DealId không tồn tại trong hệ thống
500	Lỗi từ phía server

Last Updated: 10/28/2025, 9:58:11 AM

← Get list of ancillary services for multiple bookings. Search for low-fare tickets Vietjet.→