Queue Place
Place a PNR booking into the queue for ticket issuance. This is typically used to queue corporate or special bookings for ticketing processing.
Endpoint
- URL:
/api/v1/flight/queue-place - 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) |
| bookingCode | string | Yes | Booking code (PNR) |
| validatingCarrier | string | No | Validating airline carrier code (2-letter IATA) |
| accountCode | string | No | Corporate account code |
Sample Request:
{
"system": "VN",
"bookingCode": "ABC123",
"validatingCarrier": "VN",
"accountCode": "CORP001"
}
Request Constraints & Business Rules
- The PNR booking must exist and be in an eligible state for queue placement.
validatingCarriershould match the airline responsible for issuing the ticket.accountCodemust represent a valid, active corporate account.
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) |
| tickets | array | Yes | List of queued/issued tickets (see BookingTicket) |
BookingTicket Object
See Issue Ticket for details of the Ticket object fields.
Sample Response:
{
"system": "VN",
"status": true,
"error": null,
"description": "PNR successfully queued for ticketing",
"trackingId": "track-q123",
"trackingTime": "2024-06-01T12:00:00Z",
"tickets": []
}
Error Codes
This endpoint may return the following error codes:
- 10000 - Issue TKT: Ticket issuance errors (10000-10005)
- 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
- What happens if the PNR is already queued or ticketed?
- How is the validating carrier code validated?
For integration support, see Contact Support.