Bookings

The state of a booking you opened. Poll every few seconds; the poll is also how LetsFG knows you are still there, which keeps a paused booking alive.

While booking_in_progress, question may carry a seat map, a paid extra, or a fare increase the run is holding a cart for — answer it through POST /flights/bookings/{booking_id}/answer within its window, or the run continues without it.

get/api/v1/flights/bookings/{booking_id}

Request

  • Base URL: https://letsfg.co/developers/api/v1
  • URL: https://letsfg.co/developers/api/v1/api/v1/flights/bookings/{booking_id}
  • Auth: API key in header X-API-Key

Path parameters

booking_idstring required

Response

Booking state

booking_idstring
state'authorised' | 'card_issued' | 'booking_in_progress' | 'awaiting_settlement' | 'completed' | 'failed' | 'needs_attention'
terminalboolean

True for completed, failed and needs_attention.

pnrstring
currencystring
held_amountnumber
charged_amountnumber

Set once the hold is captured against a real PNR.

card_last4string
failure_reasonstring
decline_reasonstring
updated_at_msinteger
offerobject
questionobject nullable

Present only while booking_in_progress and something needs you. kind is seat, extra or price_change; round must be echoed to the answer route.

messagestring

Changes