Price Quote
Quote the current price for an existing booking. This endpoint provides detailed pricing information including base fare, taxes, and total cost for the booking.
Endpoint
- URL:
/api/v1/flight/pricequote - 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 | No | Booking system code (e.g., VN, VJ, 1A) |
| bookingCode | string | No | Booking code (PNR) |
| caCode | string | No | Corporate account code (if applicable) |
| issueDate | string | No | Ticket issue date (if applicable, date format) |
Example Request:
{
"system": "VN",
"bookingCode": "ABC123",
"caCode": "CORP001",
"issueDate": "2024-06-01"
}
Request Constraints & Business Rules
- Only existing bookings can be quoted for price.
- The
bookingCodemust match an existing booking. - Price quotes may vary based on current market conditions and availability.
- Quotes are typically valid for a limited time period.
- Some bookings may not be eligible for price quotes depending on their status.
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) |
| bookingCode | string | Yes | Booking code (PNR) |
| totalAmount | number | No | Total price including taxes and fees |
Error Object
| Field | Type | Nullable | Description |
|---|---|---|---|
| id | integer | No | Error code ID |
| message | string | Yes | Error message |
Example Response:
{
"system": "VN",
"status": true,
"error": null,
"description": null,
"trackingId": "abc-123",
"trackingTime": "2024-06-01T12:00:00Z",
"bookingCode": "ABC123",
"totalAmount": 2350000.0
}
Error Codes
See Error Codes for details on possible error responses.
Security & Validation
- All input is validated for type and required fields.
- Only authenticated users can access this endpoint.
- Booking codes are validated against existing bookings.
- All actions are logged and traceable.
Validation Questions
- What booking statuses are eligible for price quotes?
- How long are price quotes valid?
- Are prices quoted in the booking's original currency or system default currency?
- What happens if the booking has been modified since the original quote?
For integration support, see Contact Support.