bookings

Oag Lookup Flight

Non-destructive OAG auto-fill for the flight edit form.

Given the in-progress edit, enrich every segment that has a flight number + departure date with OAG schedule data (departure/arrival times, duration, terminals, aircraft, …) and return the enriched flight WITHOUT persisting. The client merges the response into the form for the user to review, then saves via PATCH. Ownership is required so this can't be used as an open OAG proxy.

post/bookings/{booking_id}/oag-lookup

Path parameters

booking_idstring uuid required

Request body

type'one-way' | 'round-trip'
pricenumber nullable

Total cash price if mentioned (null if fully award-booked)

currencystring

ISO 4217 currency code (e.g., USD, EUR, JPY)

confirmation_numberstring nullable
booking_referencestring nullable

Airline PNR / record locator (6-char alphanumeric, e.g., 'ABCDEF'). Different from confirmation_number which may be an OTA/agent booking code.

eticket_numberstring nullable

E-ticket number (typically 13 digits, e.g., '0012345678901')

fare_classstring nullable

Fare/booking class letter (e.g., 'Y', 'B', 'J', 'W')

checked_bagsinteger nullable

Number of checked bags included or purchased

carry_on_bagsinteger nullable

Number of carry-on bags included

check_in_urlstring nullable

Online check-in URL if present in the email

oag_enriched_atstring nullable

ISO timestamp when OAG enrichment was applied

passenger_countinteger nullable

Number of adult passengers on this booking (e.g., 2 passengers)

passenger_namesstring[]

Names of passengers if listed (e.g., ['John Smith', 'Jane Smith'])

childreninteger nullable

Number of child passengers (aged 2-11)

infantsinteger nullable

Number of infant passengers (under 2)

Response

Successful Response

type'one-way' | 'round-trip'
pricenumber nullable

Total cash price if mentioned (null if fully award-booked)

currencystring

ISO 4217 currency code (e.g., USD, EUR, JPY)

confirmation_numberstring nullable
booking_referencestring nullable

Airline PNR / record locator (6-char alphanumeric, e.g., 'ABCDEF'). Different from confirmation_number which may be an OTA/agent booking code.

eticket_numberstring nullable

E-ticket number (typically 13 digits, e.g., '0012345678901')

fare_classstring nullable

Fare/booking class letter (e.g., 'Y', 'B', 'J', 'W')

checked_bagsinteger nullable

Number of checked bags included or purchased

carry_on_bagsinteger nullable

Number of carry-on bags included

check_in_urlstring nullable

Online check-in URL if present in the email

oag_enriched_atstring nullable

ISO timestamp when OAG enrichment was applied

passenger_countinteger nullable

Number of adult passengers on this booking (e.g., 2 passengers)

passenger_namesstring[]

Names of passengers if listed (e.g., ['John Smith', 'Jane Smith'])

childreninteger nullable

Number of child passengers (aged 2-11)

infantsinteger nullable

Number of infant passengers (under 2)

Changes

Changed in 1 of the 22 revisions of this API.44

  • 1060a62bfafc44See the full diff
    • ●

      removed the request property //

      request-property-removed

    • ●

      removed the request property //

      request-property-removed

    • ●

      removed the optional property // from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property // from the response with the status

      response-optional-property-removed

    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added