RahalCorporate
OrdersReference

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

StatusCodeDescription
OKOKReservation confirmed
In ProgressIN_PROGRESSBeing processed
RefundedREFUNDEDCancelled/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:

ScenarioOrder Status
All reservations OKFINALIZED
Any reservation IN_PROGRESSIN_PROGRESS or PAID
Processing failedFAILED
All refundedREFUNDED (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:

CurrentCan Change ToUse Case
IN_PROGRESSOKManual confirmation
IN_PROGRESSREFUNDEDBooking failed/cancelled
OKREFUNDEDPost-confirmation cancellation

Dashboard Display

Reservation status is color-coded:

StatusColorMeaning
OKGreenNormal/success
IN_PROGRESSRedNeeds attention
REFUNDEDRedCancelled

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

On this page