Send Queue
Send booking to queue for processing or manual review by airline agents. This endpoint handles queue management for bookings that require special attention or manual intervention.
Endpoint
- URL:
/api/v1/flight/sendqueue - 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) |
| queueNumber | string | No | Queue number to assign booking to |
| categoryNumber | string | No | Queue category number for classification |
Example Request:
{
"system": "VN",
"bookingCode": "ABC123",
"queueNumber": "10",
"categoryNumber": "2"
}
Request Constraints & Business Rules
- The booking must exist and be in a valid state for queue assignment.
- Queue numbers must be valid for the specified system.
- Category numbers must correspond to existing queue categories.
- Only certain booking statuses allow queue assignment.
- Queue assignments are logged for audit and tracking purposes.
- Different queue types may have different processing priorities.
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) |
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"
}
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 verified against existing bookings.
- Queue numbers and categories are validated against system configuration.
- All queue assignment actions are logged and traceable.
- Access control ensures only authorized users can assign to specific queues.
Validation Questions
- What are the valid queue numbers and their purposes for each system?
- Are there restrictions on which booking statuses can be queued?
- How are queue priorities determined and processed?
- Can bookings be moved between queues after initial assignment?
For integration support, see Contact Support.