Skip to main content
POST
/
flight
/
booking
/
status
Get Booking Details
curl --request POST \
  --url https://api.travomatrix.com/api/v1/flight/booking/status \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "booking_id": "<string>",
  "pnr": "<string>"
}
'
Monitoring the state of a booking is critical for accurate order management. Travomatrix uses a formal state machine to govern the lifecycle of every flight reservation.

​
Booking State Machine

Every booking transition is validated against a strict state machine to prevent invalid operations (like issuing a ticket for a cancelled booking).

​
Status Values

StatusDescription
PENDINGThe booking request is being processed by the provider.
BOOKEDThe PNR has been generated but not yet ticketed.
TICKETEDThe ticket numbers have been issued. The passenger is ready to fly.
FAILEDThe booking or ticketing attempt failed permanently.
CANCELLEDThe booking has been voided or cancelled by the user or administrator.
REFUNDEDThe refund amount has been successfully credited back to the agent’s wallet.
FLOWNAll segments in the booking have been completed.

​
Polling vs. Events

While you can poll this endpoint using the booking_id or pnr, we recommend using the X-Request-ID for tracking asynchronous operations. For production integrations, consider setting up a Webhook listener (Enterprise only).

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
booking_id
string
​
pnr
string

Response

200

Current booking state and PNR details.