Skip to main content

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

FieldTypeRequiredDescription
systemstringYesBooking system code (e.g., VN, VJ, 1A)
bookingCodestringYesBooking code (PNR)
validatingCarrierstringNoValidating airline carrier code (2-letter IATA)
accountCodestringNoCorporate 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.
  • validatingCarrier should match the airline responsible for issuing the ticket.
  • accountCode must represent a valid, active corporate account.

Response Structure

FieldTypeNullableDescription
systemstringYesSystem name (e.g., VN, VJ, 1A)
statusbooleanNotrue if successful, false if failed
errorobjectYesError details (if any)
descriptionstringYesError description (if any)
trackingIdstringYesTracking ID for request logs
trackingTimestringYesTime for request tracking (ISO 8601 format)
ticketsarrayYesList 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:

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.