Skip to main content

Booking Workflow

Complete workflow for booking flights through the API.

Step 1: Search for Flights​

POST /api/flight/search

Step 2: Lock Price​

POST /api/flight/offer

Request body: { "flightOffer": <one offer from search> }. Response: { "meta": { "count", "currency" }, "data": [ ... ] }. Use data[0] as flightOffer in the next step.

Step 3: Create Reservation​

POST /api/flight/reserve/agent

Step 4: Retrieve Ticket​

GET /api/flight/tickets?ticketId=<TICKET_ID>

Payment Flow​

  1. Wallet balance is checked
  2. If sufficient, reservation is created
  3. Funds are deducted from wallet
  4. Ticket is issued
  5. Confirmation is sent (if notifications enabled)