Reservation Statuses
Complete reference for reservation status values and their meanings
Reservation Statuses
Reservations have their own status independent of the parent order.
Status Values
| Status | Code | Description |
|---|---|---|
| OK | OK | Reservation confirmed |
| In Progress | IN_PROGRESS | Being processed |
| Refunded | REFUNDED | Cancelled/refunded |
Detailed Descriptions
OK
The reservation is confirmed and active.
Characteristics:
- External booking confirmed with supplier
- For flights: ticket issued
- Service dates populated
- Ready for travel
Dashboard Display: Green chip
IN_PROGRESS
The reservation is being processed.
Characteristics:
- Initial status when reservation created
- Awaiting supplier confirmation
- For auto-ticketing: awaiting ticket issuance
- May have background retries in progress
Dashboard Display: Red chip (needs attention)
REFUNDED
The reservation has been cancelled and refunded.
Characteristics:
- Booking cancelled with supplier
- Refund processed to customer
- No longer valid for travel
Dashboard Display: Red chip
Status Transitions
Status by Service Type
Flight Reservations (AIR)
IN_PROGRESS (booking created)
↓
OK (ticket issued)
↓
REFUNDED (cancelled)Flights require ticket issuance before becoming OK.
Hotel Reservations (HOTEL)
IN_PROGRESS (booking created)
↓
OK (confirmed immediately)
↓
REFUNDED (cancelled)Hotels typically confirm immediately without a ticketing step.
Relationship to Order Status
Reservation status affects order status:
| Scenario | Order Status |
|---|---|
| All reservations OK | FINALIZED |
| Any reservation IN_PROGRESS | IN_PROGRESS or PAID |
| Processing failed | FAILED |
| All refunded | REFUNDED (typically) |
An order may remain FINALIZED even if individual reservations are refunded, depending on the business scenario.
Manual Status Changes
Administrators can update reservation status when managing reservations:
| Current | Can Change To | Use Case |
|---|---|---|
IN_PROGRESS | OK | Manual confirmation |
IN_PROGRESS | REFUNDED | Booking failed/cancelled |
OK | REFUNDED | Post-confirmation cancellation |
Dashboard Display
Reservation status is color-coded:
| Status | Color | Meaning |
|---|---|---|
OK | Green | Normal/success |
IN_PROGRESS | Red | Needs attention |
REFUNDED | Red | Cancelled |
API Representation
In API responses:
{
"id": "res_123",
"reservationId": "12345678",
"status": "OK",
"service": "AIR",
...
}Filter by status when querying reservations:
GET /admin/reservations?status=IN_PROGRESS