Search for low-fare tickets Vietjet.
# 1. Tổng quan
- Action URL:
/api/v1/vj/flight/low-fare - Đặc tả chi tiết: Swagger UI (opens new window)
- Tính năng: API tìm kiếm vé rẻ (low fare) của Vietjet Air.
- Phạm vi áp 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
- Bước 1: Xây dựng request với đầy đủ header và body
- Bước 2: Gửi request
POSTtới Action URL - Bước 3: Nhận về response chứa danh sách các chuyến bay khứ hồi tương ứng với thông tin tìm kiếm.
# 3. Request
# 3.1 Ví dụ
{
"cityPair": "HAN-SGN",
"departure": "2025-10-25",
"cabinClass": "Y",
"currency": "VND",
"adultCount": 1,
"childCount": 0,
"infantCount": 0,
"daysBeforeDeparture": 8,
"daysAfterDeparture": 8,
"earliestDeparture": "string",
"latestDeparture": "string",
"daysBeforeReturn": 10,
"daysAfterReturn": 10,
"earliestReturn": "string",
"latestReturn": "string",
"promoCode": "string",
"standby": "string"
}
# 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ụ |
|---|---|---|---|---|
| cityPair | Có | String | Sân bay khởi hành (mã IATA) | |
| departure | Có | String | Ngày khởi hành | |
| adultCount | Có | Number | Số lượng người lớn | |
| childCount | Không | Number | Số lượng trẻ em | |
| infantCount | Không | Number | Số lượng em bé | |
| cabinClass | Có | String | Hạng ghế | |
| currency | Có | String | Loại tiền tệ hiển thị | |
| daysAfterDeparure | Không | Number | Số ngày sau ngày khởi hành được phép tìm kiếm | |
| earliestDeparture | Không | String | Thời gian khởi hành sớm nhất | |
| latesDeparture | Không | String | Thời gian khởi hành muộn nhất | |
| daysBeforeReturn | Không | integer | Số ngày trước ngày về | |
| daysAfterReturn | Không | integer | Số ngày sau ngày về được phép tìm kiếm | |
| earliestReturn | Không | String | Thời gian bay về sớm | |
| latestReturn | Không | String | Thời gian bay về muộn | |
| promoCode | Không | String | Mã khuyến mãi, nếu có | |
| standby | Không | String | Thông tin trạng thái chờ |
# 4. Response
# 4.1 Ví dụ
{
"statusCode": 200,
"timestamp": "2025-10-27T06:50:26.550Z",
"path": "/api/v1/vj/flight/low-fare",
"message": "Tìm kiếm low fare Vietjet thành công",
"data": {
"success": true,
"fares": [
{
"departureDate": "2025-10-27",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-10-28",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-10-29",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-10-30",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-10-31",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-11-01",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-11-02",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-11-03",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-11-04",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
},
{
"departureDate": "2025-11-05",
"cityPair": {
"identifier": "HAN-SGN"
},
"fareOption": {
"fareClass": {
"key": "wb4xb3F9Evee1nOH8bSvfVF5maLbtNwnhq04KglS7bs=",
"code": "E1_ECO",
"description": "Eco1"
},
"cabinClass": {
"code": "Y",
"description": "Economy"
},
"fareType": {
"identifier": "Eco",
"description": "Eco"
},
"fareCharges": [
{
"description": "Eco1",
"chargeType": {
"code": "FA",
"description": "Fare",
"feeCategory": null,
"index": 20
},
"currencyAmounts": [
{
"baseAmount": 422000,
"discountAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
]
}
]
},
"promoCodeApplicability": {
"promoCodeRequested": true,
"promoCodeValidity": {
"valid": false,
"notApplicable": true,
"noMarket": false,
"invalidFlightDate": false,
"notAvailable": false,
"invalidAvailability": false
},
"promoCode": "string"
}
}
],
"total": 10
},
"errors": null
}
# 4.2 Cấu trúc dữ liệu Request
| Thuộc tính | Kiểu dữ liệu | Mô tả | Ví dụ |
|---|---|---|---|
| StatusCode | String | Tình trạng tạo sub | |
| Timestamp | String | Thời gian xử lý request | |
| Path | String | ||
| Message | String | Thông báo kết quả | |
| Errors | String | Thông tin lỗi nếu có | |
| RequestId | String | Mã định danh request | |
| TotalDuration | string | Thời gian xử lý (ms) | |
| success | Boolean | Kết quả xử lý | |
| fares | Array | Danh sách giá vé thấp nhất theo từng ngày | |
| total | Integer | Tổng số phần tử trong danh sách | |
| departureDate | String | Ngày khởi hành | |
| cityPair | Object | Cặp điểm bay | |
| fareOption | Object | Thông tin chi tiết về hạng vé và giá | |
| promoCodeApplicability | Object | Thông tin áp dụng mã khuyến mãi | |
| identifier | String | Mã cặp sân bay đi – đến | |
| fareClass | Object | Hạng vé cụ thể | |
| cabinClass | Object | Loại khoang | |
| fareType | Object | Loại vé | |
| fareCharges | Array | Danh sách các loại phí cấu thành giá vé | |
| key | String | Khóa định danh hạng vé | |
| code | String | Mã hạng vé/khoang | |
| description | String | Mô tả hạng vé/khoang | |
| identifier | String | Mã loại vé | |
| chargeType | Object | Loại phí | |
| currencyAmounts | Array | Giá trị tiền tệ cụ thể | |
| feeCategory | String | Danh mục phí( nếu có) | |
| index | Integer | Thứ tự hiển thị phí | |
| baseAmount | Number | Giá gốc | |
| discountAmount | Number | Number | |
| currency | Object | Thông tin tiền tệ | |
| promoCodeRequested | Boolean | Có yêu cầu mã khuyến mãi không | |
| promoCodeValidity | Object | Tình trạng hợp lện của mã khuyến mãi | |
| promoCode | String | Mã khuyến mãi được nhập | |
| valid | Boolean | Mã có hợp lệ không | |
| notApplicable | Boolean | Không áp dụng được | |
| noMarket | Boolean | Không hợp lệ theo thị trường | |
| invalidFlightDate | Boolean | Ngày bay không hợp lệ | |
| notAvailable | Boolean | Không có sẵn chương trình | |
| invalidAvailability | Boolean | Không đủ điều kiện |
# 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
← Search for a one-way flight Vietjet. Search for multi-city flightsVietjet.→