Developer API

Built for agents

Every operation on this site is available over a REST API that shares the same service layer as the website — so anything a guest can do, an AI agent can do too. Responses use a { success, summary, data } envelope with a plain-English summary on every result.

Base URL

/api

API key (x-api-key header)

agentic-demo-key

OpenAPI spec

/api/openapi.json

Every response is wrapped in the Envelope: { success, summary, data } on success, or { success: false, error } on failure. The data shape for each endpoint is named below and defined in full under Schemas.

Endpoints

GET/api/healthNo auth

Liveness check and store size. Use to confirm the API is up. No authentication.

Response · data Health

GET/api/airports

List every airport in the Agentic Airways network, for building search UIs or validating codes.

Response · data Airport[]

GET/api/destinations

Nonstop destinations reachable from an origin, cheapest-first — answers "where can I fly from here?".

Parameters

origin

string

Required (query). Origin airport code.

Response · data Destination[]

GET/api/flights/search

Search for a route on a date. Always returns nonstop AND connecting options (connections route through a hub — London/New York/Los Angeles — with a ≥2-hour connection).

Parameters

origin	string	Required. Origin airport code, e.g. SEA.
destination	string	Required. Destination airport code, e.g. JFK.
date	string	Required. Departure date, YYYY-MM-DD (origin-local).
passengers	integer	Optional. Seats needed for availability (default 1).
cabin	string	Optional. Preferred cabin (economy \| premium \| business \| first); flights lacking it are still returned.
maxConnections	integer	Optional. Max connecting options to return (default 4).

Response · data Itinerary[]

GET/api/flights/status

Get live status (on-time/delayed/cancelled + reason) for a flight number. Defaults to the next upcoming departure.

Parameters

flightNumber	string	Required. Flight number, e.g. AG145.
date	string	Optional. Pin to a specific departure date, YYYY-MM-DD.

Response · data Flight

GET/api/flights/{flightId}

Retrieve one flight by its instance id, with fares and live status.

Parameters

flightId

string

Required (path). Flight id, e.g. AG145-2026-08-20.

Response · data Flight

GET/api/flights/{flightId}/seatmap

Get the seat map and live seat availability for a flight.

Parameters

flightId

string

Required (path). Flight id.

Response · data SeatMap

POST/api/reservations

Book a flight (create a reservation). Pass one flightId per segment; a connecting journey has multiple flightIds.

Request body (JSON)

flightIds	string[]	Required. Flight ids to book, one per segment.
cabin	string	Optional. Default cabin for all segments (economy \| premium \| business \| first); defaults to economy.
cabins	string[]	Optional. Per-segment cabins, parallel to flightIds (overrides cabin).
passengers	PassengerInput[]	Required. Passengers: { firstName, lastName, email?, dateOfBirth?, loyaltyId? }.
contactEmail	string	Optional. Contact email for the booking.
loyaltyId	string	Optional. Meridian Club member id to attach.
travelCreditCodes	string[]	Optional. Travel-credit certificate codes to redeem against the total.

Response · data Reservation

POST/api/reservations/preview

Price a NEW booking WITHOUT committing (preview-before-book). Non-mutating: nothing is created, no inventory is taken, and travel credits are quoted but NOT redeemed. Shares pricing with the real create path so the quote can never differ from what booking charges.

Request body (JSON)

flightIds	string[]	Required. Flight ids to price, one per segment.
cabin	string	Optional. Default cabin for all segments (economy \| premium \| business \| first); defaults to economy.
cabins	string[]	Optional. Per-segment cabins, parallel to flightIds (overrides cabin).
passengers	PassengerInput[]	Required. Passengers: { firstName, lastName, email?, dateOfBirth?, loyaltyId? }.
contactEmail	string	Optional. Contact email for the booking.
loyaltyId	string	Optional. Meridian Club member id to attach.
travelCreditCodes	string[]	Optional. Travel-credit certificate codes to quote against the total (not redeemed).

Response · data BookingPreview

GET/api/reservations/{pnr}

Retrieve a reservation by confirmation code and last name.

Parameters

pnr	string	Required (path). 6-char confirmation code.
lastName	string	Required (query). Passenger last name on the booking.

Response · data Reservation

POST/api/reservations/{pnr}/passenger

Correct a traveller's name or date of birth on a booking (e.g. fix a spelling).

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. A current passenger last name on the PNR (for lookup).
passengerId	string	Required. The passenger to update.
firstName	string	Optional. New first name.
newLastName	string	Optional. New last name.
dateOfBirth	string	Optional. New date of birth (YYYY-MM-DD).

Response · data Reservation

POST/api/reservations/{pnr}/change

Change/rebook one segment onto a different flight. Seats reset and a fare difference is computed.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Segment to change.
newFlightId	string	Required. Replacement flight id.
cabin	string	Optional. New cabin (economy \| premium \| business \| first); defaults to current.

Response · data ChangeResult

GET/api/reservations/{pnr}/change-preview

Quote a flight change (fare difference / waiver / reason) WITHOUT committing — the read-only counterpart to change.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.
segmentId	string	Required (query). Segment to change.
newFlightId	string	Required (query). Replacement flight id.
cabin	string	Optional (query). New cabin (economy \| premium \| business \| first); defaults to current.

Response · data ChangePreview

POST/api/reservations/{pnr}/cancel

Cancel a reservation. Refundable fares are refunded; others become travel credit.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName

string

Required. Passenger last name.

Response · data CancelResult

GET/api/reservations/{pnr}/cancel-preview

Quote a cancellation outcome (refund vs. travel credit + reason) WITHOUT committing — the read-only counterpart to cancel.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.

Response · data CancelPreview

POST/api/reservations/{pnr}/seats

Assign or change a seat for a passenger on a segment.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Segment.
passengerId	string	Required. Passenger reference.
seat	string	Required. Seat number, e.g. 14C.

Response · data SeatAssignResult

POST/api/reservations/{pnr}/checkin

Check in for a flight (opens 24h before departure, closes 60m before). Auto-assigns a seat to anyone without one and issues boarding passes.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Optional. Segment; defaults to the next upcoming segment.
passengerIds	string[]	Optional. Passengers to check in; defaults to all.

Response · data CheckInResult

GET/api/reservations/{pnr}/boarding-passes

List boarding passes already issued for a reservation.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.

Response · data BoardingPass[]

POST/api/reservations/{pnr}/baggage

Add checked bags for a passenger on a segment. The effective free allowance is the best of the fare and the member's Meridian tier; fees are by absolute bag position with additive overweight/oversize surcharges.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Segment.
passengerId	string	Required. Passenger reference.
count	integer	Required. Number of bags to add (≥1).
items	object[]	Optional. Per-bag { weightLbs?, linearInches?, itemType? } (index-aligned to count). itemType = standard \| sporting_equipment (oversize waived) \| musical_instrument \| firearm (locked case) \| pet (flat $200 cargo). A bag over 100 lb or 115 in is refused (409).

Response · data BaggageResult

GET/api/baggage/fee-schedule

The single current checked-bag fee schedule (1st $45, 2nd $55, 3rd+ $200 per direction, plus overweight/oversize surcharges). The website, API, and KB all read these same numbers.

Response · data BaggageFeeSchedule

POST/api/reservations/{pnr}/upgrade

Request a cabin upgrade. Pass `method` to commit a specific option from the upgrade quote (charged/deducted at the quoted amount); omit it to auto-select complimentary → miles → paid.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Segment to upgrade.
targetCabin	string	Optional. Target cabin (premium \| business \| first); defaults to next cabin up.
method	string	Optional. Commit a specific upgrade method: complimentary \| miles \| miles_plus_money \| paid. Amounts match the upgrade quote for that method; an ineligible method is rejected. Omit to auto-select.

Response · data UpgradeResult

GET/api/loyalty/{memberId}

Look up a Meridian Club loyalty account by member number (includes the member's tier benefits).

Parameters

memberId

string

Required (path). Member number, e.g. AG7781234.

Response · data Loyalty

POST/api/loyalty/{memberId}/profile

Update a member's own profile (name / email / phone). Tier and miles are not editable here.

Parameters

memberId

string

Required (path). Member number.

Request body (JSON)

firstName	string	Optional. New first name.
lastName	string	Optional. New last name.
email	string	Optional. New account email.
phone	string	Optional. New contact phone (empty string clears it).
dateOfBirth	string	Optional. Date of birth (YYYY-MM-DD).

Response · data Loyalty

GET/api/wallet/{memberId}

A member's travel-credit wallet — certificate balances and expirations (redeem codes at booking via travelCreditCodes).

Parameters

memberId

string

Required (path). Member number.

Response · data Wallet

GET/api/loyalty/{memberId}/reservations

All reservations belonging to a member (matched by Meridian number or account email); segments carry `departed` so you can split upcoming vs. past.

Parameters

memberId

string

Required (path). Member number.

Response · data Reservation[]

GET/api/loyalty/{memberId}/benefits

The member's tier entitlements (free checked bags, complimentary-upgrade cabins + clearance windows, complimentary preferred seating) so the agent quotes benefits from data.

Parameters

memberId

string

Required (path). Member number, e.g. AG7781234.

Response · data TierBenefits

GET/api/reservations/{pnr}/upgrade-quote

Quote all upgrade methods for a segment — complimentary (with clearance time), miles + money hybrid, and paid fare difference.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.
segmentId	string	Required (query). Segment to upgrade.
targetCabin	string	Required (query). premium \| business \| first.

Response · data UpgradeQuote

GET/api/award-quote

Distance-/region-based 'starting at' award price for a route + cabin (the 'Quote Award Redemption' action).

Parameters

origin	string	Required (query). Origin code.
destination	string	Required (query). Destination code.
cabin	string	Required (query). economy \| premium \| business \| first.

Response · data AwardQuote

GET/api/lounge/locations

The Meridian Lounge network (optionally filtered by airport).

Parameters

airportCode

string

Optional (query). Filter to one airport.

Response · data Lounge[]

GET/api/reservations/{pnr}/lounge-eligibility

Precomputed lounge-access decision for a passenger on a segment (membership / eligible First / international Business / day pass), so the agent never says 'yes' from tier alone.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.
segmentId	string	Required (query). Segment.
passengerId	string	Required (query). Passenger reference.

Response · data LoungeEligibility

POST/api/lounge/day-pass

Buy a single-entry Meridian Lounge pass ($65, or $35 for a complimentary-upgrade guest); requires same-day travel from a lounge airport.

Request body (JSON)

pnr	string	Required. Confirmation code.
lastName	string	Required. Passenger last name.
segmentId	string	Required. Segment departing from the lounge airport.
passengerId	string	Required. Passenger reference.

Response · data LoungePassPurchase

GET/api/lounge/membership/{memberId}

A member's Meridian Lounge membership status.

Parameters

memberId

string

Required (path). Member number.

Response · data LoungeMembershipStatus

POST/api/lounge/membership/{memberId}

Purchase or renew a Meridian Lounge membership (1-year term).

Parameters

memberId

string

Required (path). Member number.

Request body (JSON)

tier

string

Required. standard | lounge_plus.

Response · data LoungeMembershipStatus

GET/api/reservations/{pnr}/disruption-care

Authoritative per-passenger disruption-care flags (meal/hotel/ground/lounge/upgrade), computed from the live delay + tier + controllability. Answer care questions from these, not the rule prose.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.
segmentId	string	Optional (query). Limit to one segment; defaults to all.

Response · data DisruptionCareEligibility[]

GET/api/reservations/{pnr}/service-recovery

List goodwill gestures issued on a reservation.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.

Response · data ServiceRecoveryOffer[]

POST/api/reservations/{pnr}/service-recovery

Issue a goodwill gesture (lounge pass / meal voucher / discount code / miles). 409 unless the disruption is airline-controlled; goodwill money/miles require a 3h+ delay or cancellation.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Disrupted segment.
type	string	Required. lounge_pass \| meal_voucher \| discount_code \| miles_credit.

Response · data ServiceRecoveryOffer

GET/api/reservations/{pnr}/denied-boarding

List denied-boarding / oversold events recorded on a reservation.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.

Response · data DeniedBoardingResult[]

POST/api/reservations/{pnr}/denied-boarding

Record a denied-boarding / oversold event. Compensation is computed server-side (US DOT 200%/400% capped $1,075/$2,150; Canada APPR CAD 400/800); never trust a client-supplied amount.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Affected segment.
passengerId	string	Required. Passenger reference.
type	string	Required. voluntary \| involuntary.
arrivalDelayMinutes	integer	Required. Delay to the passenger's arrival.

Response · data DeniedBoardingResult

GET/api/reservations/{pnr}/special-services

List a reservation's special-service requests.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.

Response · data SpecialServiceRequest[]

POST/api/reservations/{pnr}/special-services

Create a special-service request (wheelchair, service animal, cabin pet, portable oxygen, allergy, etc.). Charges the correct fee ($0 accessibility / $100 cabin pet). A restricting SSR blocks exit-row seat assignment.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
passengerId	string	Required. Passenger reference.
type	string	Required. wheelchair \| service_animal \| pet_cabin \| poc_oxygen \| deaf_hard_of_hearing \| blind_low_vision \| allergy.
segmentId	string	Optional. Scope to one segment.
details	object	Optional. Type-specific details.

Response · data SpecialServiceRequest

POST/api/reservations/{pnr}/unaccompanied-minor

Register Unaccompanied Minor service for a child (ages 5–17). Fee is $50 for ages 5–12, waived for a Gold/Platinum guardian. (Illegal lone-minor itineraries are rejected at booking.)

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
passengerId	string	Required. The minor.
guardianContact	object	Required. Drop-off / pickup contact details.

Response · data UnaccompaniedMinorResult

POST/api/reservations/{pnr}/seats/auto-assign-family

Batch-assign adjacent seats for everyone on a segment (family seating; child ≤13 next to an adult, no charge).

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Segment.

Response · data FamilySeatingResult

GET/api/aircraft/{type}/carry-on-policy

Carry-on, personal-item, and lithium-battery reference policy for an aircraft type (gate-check likelihood on regionals).

Parameters

type

string

Required (path). Aircraft type, e.g. 'Boeing 787-9'.

Response · data CarryOnPolicy

GET/api/reservations/{pnr}/baggage-claims

List baggage claims filed on a reservation.

Parameters

pnr	string	Required (path). Confirmation code.
lastName	string	Required (query). Passenger last name.

Response · data BaggageClaim[]

POST/api/reservations/{pnr}/baggage-claims

File a baggage claim (delayed / damaged / lost / left_on_board) and return the file id + applicable liability cap.

Parameters

pnr

string

Required (path). Confirmation code.

Request body (JSON)

lastName	string	Required. Passenger last name.
segmentId	string	Required. Affected segment.
passengerId	string	Required. Passenger reference.
type	string	Required. delayed \| damaged \| lost \| left_on_board.

Response · data BaggageClaim

POST/api/loyalty

Enroll a new Meridian Club member (Blue tier) and return their member number.

Request body (JSON)

firstName	string	Required. First name.
lastName	string	Required. Last name.
email	string	Required. Email.
dateOfBirth	string	Optional. Date of birth (YYYY-MM-DD).

Response · data Loyalty

GET/api/operations

Operational snapshot: on-time performance and categorized disruptions across flights departing within the window.

Parameters

days

integer

Optional. Window size in days (default 7).

Response · data OperationsSnapshot

POST/api/admin/reset

Reset all demo data (flights, reservations, loyalty) to a clean seed. Use to restore a known state before a demo.

Response · data ResetResult

Schemas

Envelope

Standard wrapper on every response. On success, `data` holds the typed payload documented per endpoint; on failure, `error` is present instead.

Fields

success	boolean	true on success, false on error.
summary	string?	Plain-English description of the result, written for an AI agent (present on success).
data	object?	The typed payload (present on success). Shape documented per endpoint.
error	ApiError?	Error detail (present on failure).

ApiError

Error payload.

Fields

code	string	Machine code: NOT_FOUND, INVALID_INPUT, NOT_ALLOWED, CONFLICT, UNAUTHORIZED, or INTERNAL.
message	string	Human-readable explanation.
details	object?	Optional structured context (e.g. flightId).

TimeInfo

A timestamp rendered in the relevant airport's local timezone.

Fields

iso	string	ISO 8601 UTC instant.
time	string	Local clock time, e.g. "3:15 PM".
date	string	Local date, e.g. "Mon, Jul 20".
timezone	string	IANA timezone of the airport.

Airport

An airport in the network.

Fields

code	string	3-letter IATA-style code (e.g. SEA).
name	string	Full airport name.
city	string	City served.
country	string	Country.
timezone	string	IANA timezone.

Disruption

Why a flight is delayed or cancelled.

Fields

category	string	crew \| maintenance \| aircraft \| airline_operations \| weather \| air_traffic_control \| security \| airport_operations \| extraordinary.
categoryLabel	string	Display label for the category.
controllable	boolean	true if within the airline's control (crew/maintenance/aircraft/ops).
responsibility	string	"airline-controlled" or "outside airline control".
reason	string	Customer-facing explanation.

Fare

A purchasable cabin fare on a single flight.

Fields

cabin	string	economy \| premium \| business \| first.
cabinLabel	string	Brand label, e.g. "Main Cabin", "Agentic Business".
price	number	Fare price (numeric).
priceFormatted	string	Formatted price, e.g. "$329".
currency	string	ISO currency code (USD).
seatsAvailable	integer	Seats remaining in this cabin.
available	boolean	true if seatsAvailable > 0.
refundable	boolean	Whether the fare is refundable on cancellation.
changeable	boolean	Whether the fare can be changed.
includedBags	integer	Checked bags included in the fare.
fareCode	string	Internal fare code.

Flight

A single scheduled flight with fares and live operational status.

Fields

id	string	Flight instance id, e.g. "AG145-2026-08-20". Use when booking.
flightNumber	string	Flight number, e.g. AG145.
origin	string	Origin airport code.
originCity	string	Origin city.
destination	string	Destination airport code.
destinationCity	string	Destination city.
departure	TimeInfo	Scheduled departure.
arrival	TimeInfo	Scheduled arrival.
durationMinutes	integer	Scheduled duration in minutes.
duration	string	Duration formatted, e.g. "5h 15m".
distanceMiles	integer	Approximate great-circle distance (drives lounge/award banding).
isInternational	boolean	true if origin and destination are in different countries.
aircraft	string	Aircraft type.
status	string	scheduled \| on_time \| delayed \| boarding \| departed \| arrived \| cancelled.
statusLabel	string	Display label for status.
onTime	boolean	true if on_time or scheduled.
delayed	boolean	true if delayed.
cancelled	boolean	true if cancelled.
delayMinutes	integer	Delay length in minutes (0 if none).
estimatedDeparture	TimeInfo?	Revised departure when delayed, else null.
estimatedArrival	TimeInfo?	Revised arrival when delayed, else null.
disruption	Disruption?	Delay/cancellation reason, else null.
gate	string?	Departure gate.
terminal	string?	Departure terminal.
fares	Fare[]	Available cabins and prices.
lowestFare	number?	Cheapest available fare, or null.
summary	string	Plain-English summary of the flight.

ItineraryLeg

One flight within an itinerary.

Fields

id	string	Flight instance id.
flightNumber	string	Flight number.
origin	string	Origin code.
originCity	string	Origin city.
destination	string	Destination code.
destinationCity	string	Destination city.
departure	TimeInfo	Departure.
arrival	TimeInfo	Arrival.
cabinsOffered	string[]	Cabins offered on this leg.
status	string	Operational status.
statusLabel	string	Status label.
aircraft	string	Aircraft type.

ItineraryFare

Combined fare for a cabin across all legs of the itinerary.

Fields

cabin	string	Cabin code.
cabinLabel	string	Cabin label.
available	boolean	true if the cabin has seats on every leg.
price	number	Sum of the cabin fare across legs.
priceFormatted	string	Formatted combined price.

Itinerary

A nonstop or connecting journey between two cities. Connecting itineraries route through a hub (LHR/JFK/LAX) with a ≥2-hour connection.

Fields

id	string	One or more flight ids joined by "+" (used when booking a connection).
type	string	"direct" or "connecting".
stops	integer	Number of stops (0 for direct, 1 for connecting).
connectVia	string?	Hub airport code for connections, else null.
connectViaCity	string?	Hub city, else null.
layover	string?	Layover duration formatted, else null.
origin	string	Journey origin code.
originCity	string	Origin city.
destination	string	Journey destination code.
destinationCity	string	Destination city.
departure	TimeInfo	First leg departure.
arrival	TimeInfo	Last leg arrival.
totalDuration	string	Total journey time formatted.
totalDurationMinutes	integer	Total journey time in minutes.
legs	ItineraryLeg[]	The flights in order.
fares	ItineraryFare[]	Combined per-cabin fares (only cabins offered on all legs).
lowestFare	number?	Cheapest available combined fare, or null.
summary	string	Plain-English summary of the itinerary.

Passenger

A passenger on a reservation.

Fields

id	string	6-char passenger reference (used for seats/baggage).
name	string	Full name.
firstName	string	First name.
lastName	string	Last name.
loyaltyId	string?	Meridian Club member id, or null.

SeatAssignment

A passenger's seat on a segment.

Fields

passengerId	string	Passenger reference.
passengerName	string	Passenger name.
seat	string?	Seat number (e.g. 14C), or null if unassigned.

Baggage

A passenger's checked-bag count on a segment.

Fields

passengerId	string	Passenger reference.
passengerName	string	Passenger name.
checkedBags	integer	Number of checked bags.

Segment

One flight within a reservation, with per-passenger seats and bags plus live status.

Fields

id	string	Segment id (used for change/seats/checkin/baggage/upgrade).
flightId	string	Underlying flight id.
flightNumber	string	Flight number.
origin	string	Origin code.
originCity	string	Origin city.
destination	string	Destination code.
destinationCity	string	Destination city.
departure	TimeInfo	Departure.
arrival	TimeInfo	Arrival.
cabin	string	Booked cabin.
cabinLabel	string	Cabin label.
fareCode	string	Fare code.
isInternational	boolean	true if the segment crosses a country border.
status	string	Live flight status.
statusLabel	string	Status label.
delayMinutes	integer	Delay minutes if delayed.
estimatedDeparture	TimeInfo?	Revised departure if delayed, else null.
disruption	Disruption?	Disruption reason if any, else null.
seats	SeatAssignment[]	Seat per passenger.
baggage	Baggage[]	Bags per passenger.
hoursToDeparture	number	Hours until departure.
departed	boolean	true if already departed.
cancelled	boolean	true if the flight is cancelled.
checkedIn	boolean	true if checked in.
hasUnassignedSeats	boolean	true if any passenger lacks a seat.
unassignedSeatCount	integer	Count of unassigned seats.
checkInWindow	string	before_open \| open \| closed \| departed (check-in opens 24h before, closes 60m before).
checkInClosesAt	string	ISO instant check-in closes (60m before departure).
bagDropDeadline	string	ISO bag-drop cutoff (40m domestic / 60m international).
canCheckIn	boolean	true if within the check-in window (open) and not yet checked in.
canChangeFlight	boolean	true if the segment can be changed.
canSelectSeats	boolean	true if seats can be selected.

Reservation

A booking (PNR) with passengers, segments, and derived action flags.

Fields

pnr	string	6-char confirmation code.
status	string	confirmed \| cancelled \| completed.
tripType	string	one-way \| round-trip \| multi-city.
passengers	Passenger[]	Passengers on the booking.
contactEmail	string	Contact email.
totalPaid	number	Total paid (numeric).
totalPaidFormatted	string	Total paid formatted.
currency	string	Currency code.
loyaltyId	string?	Primary member id, or null.
segments	Segment[]	Flights on the booking.
canCheckIn	boolean	true if any segment can be checked in now.
canChange	boolean	true if the booking can be changed.
canCancel	boolean	true if the booking can be cancelled.
fullyCheckedIn	boolean	true if all segments are checked in or departed.
hasUnassignedSeats	boolean	true if any upcoming segment has unassigned seats.
summary	string	Plain-English summary of the reservation.

BookingPreviewLeg

One flight within a booking preview, with its per-passenger fare.

Fields

flightId	string	Flight instance id.
flightNumber	string	Flight number.
origin	string	Origin airport code.
destination	string	Destination airport code.
cabin	string	Cabin priced on this leg.
cabinLabel	string	Brand cabin label.
farePerPassengerUsd	number	One passenger's fare on this leg.

BookingPreviewPassenger

A passenger's total fare across all legs in a booking preview.

Fields

name	string	Passenger full name.
fareUsd	number	This passenger's fare across all segments.

BookingPreview

A fully priced quote for a NEW booking that is NOT created — nothing is booked, no inventory is taken, and travel credits are quoted but NOT redeemed. The quoted total can never differ from what booking will charge.

Fields

tripType	string	one-way \| round-trip \| multi-city.
currency	string	Currency code (USD).
passengerCount	integer	Number of passengers priced.
legs	BookingPreviewLeg[]	Per-leg fares in order.
perPassenger	BookingPreviewPassenger[]	Per-passenger fare totals.
fareTotal	number	Fare subtotal across all passengers, before any credit.
taxesFees	number	Taxes and fees (demo fares are all-inclusive → 0).
subtotal	number	fareTotal + taxesFees.
creditApplied	number	Travel credit that WOULD apply (quoted, not redeemed).
appliedCreditCodes	string[]	Credit certificate codes that would be used.
totalDueUsd	number	Amount due to card after credit.
summary	string	Plain-English quote (states nothing was booked).

Seat

A physical seat on an aircraft.

Fields

number	string	Seat number, e.g. 14C.
row	integer	Row number.
column	string	Column letter.
cabin	string	Cabin the seat is in.
type	string	window \| middle \| aisle.
available	boolean	true if the seat is free.
extraLegroom	boolean	true for extra-legroom seats.
exitRow	boolean	true for exit-row seats.
price	number	Seat-selection fee.
seatTier	string?	standard \| preferred (Main Cabin Preferred; fee waived for elites).

SeatMapCabin

Availability summary for one cabin.

Fields

cabin	string	Cabin code.
cabinLabel	string	Cabin label.
totalSeats	integer	Total seats in the cabin.
availableSeats	integer	Available seats.
sampleAvailable	string[]	Up to 12 example available seat numbers.

SeatMap

The full seat map for a flight with live availability.

Fields

flightId	string	Flight id.
aircraft	string	Aircraft type.
cabins	SeatMapCabin[]	Per-cabin availability summary.
seats	Seat[]	Every seat with availability.
summary	string	Plain-English availability summary.

Loyalty

A Meridian Club loyalty account.

Fields

memberId	string	Member number, e.g. AG7781234.
name	string	Member full name.
firstName	string	First name.
lastName	string	Last name.
email	string	Account email.
phone	string?	Contact phone, or null.
dateOfBirth	string?	Date of birth (YYYY-MM-DD), or null.
tier	string	blue \| silver \| gold \| platinum.
tierLabel	string	Tier label, e.g. "Meridian Gold".
miles	integer	Miles balance.
milesFormatted	string	Miles balance formatted.
milesToNextTier	integer	Miles to the next tier (0 at top tier).
benefits	TierBenefits	The member's tier entitlements (bags, upgrades, seating).
summary	string	Plain-English account summary.

TierBenefits

The concrete entitlements a Meridian Club tier confers (single source of truth for benefit quoting).

Fields

tier	string	blue \| silver \| gold \| platinum.
tierLabel	string	Tier label, e.g. "Meridian Gold".
freeCheckedBags	integer	Free checked bags (Blue 0, Silver 1, Gold 2, Platinum 3).
complimentaryUpgradeCabins	string[]	Cabins eligible for a complimentary upgrade.
complimentaryUpgradeCabinLabels	string[]	Human labels for those cabins.
upgradeClearanceHoursBeforeDeparture	integer	When complimentary upgrades start clearing (Silver 48, Gold 72, Platinum 120).
complimentaryPreferredSeat	boolean	true if Main Cabin preferred seats are complimentary.
summary	string	Plain-English benefits summary.

BoardingPass

An issued boarding pass.

Fields

pnr	string	Confirmation code.
passengerName	string	Passenger name.
flightNumber	string	Flight number.
origin	string	Origin code.
destination	string	Destination code.
departureTime	string	ISO departure instant.
arrivalTime	string	ISO arrival instant.
departureLocal	string	Local departure time.
departureDate	string	Local departure date.
cabin	string	Cabin.
seat	string	Seat number.
boardingGroup	string	Tier-aware boarding group: preboard \| priority \| A \| B \| D \| E.
boardingGroupBasis	string	Plain-English reason for the boarding group (e.g. "Meridian Platinum → Priority Boarding").
gate	string?	Gate.
terminal	string?	Terminal.
sequence	integer	Boarding sequence number.
barcode	string	Boarding-pass barcode string.
checkInClosesAt	string	ISO instant check-in closed (60m before departure).
bagDropDeadline	string	ISO bag-drop cutoff (40m domestic / 60m international).
boardingDoorClosesAt	string	ISO instant the boarding door closes (15m before departure).
summary	string	Plain-English boarding-pass summary.

OpsCategoryCount

Disruption count for one cause category.

Fields

category	string	Disruption category.
count	integer	Number of disrupted flights in this category.
controllable	boolean	true if airline-controlled.

OpsFlightRow

A delayed or cancelled flight in the operations window.

Fields

id	string	Flight id.
flightNumber	string	Flight number.
origin	string	Origin code.
destination	string	Destination code.
departureTime	string	ISO departure instant.
status	string	delayed \| cancelled.
delayMinutes	integer	Delay minutes (0 for cancellations).
category	string?	Disruption category, or null.
controllable	boolean?	Whether airline-controlled, or null.
reason	string?	Customer-facing reason, or null.

OperationsSnapshot

Live operational health across flights departing within the window.

Fields

windowDays	integer	Days ahead included.
totalFlights	integer	Departures in the window.
byStatus	object	Map of status -> count.
onTimePerformance	number	On-time percentage (0-100).
disrupted	integer	Flights with a disruption.
controllable	integer	Airline-controlled disruptions.
uncontrollable	integer	Disruptions outside airline control.
byCategory	OpsCategoryCount[]	Disruption counts by cause.
disruptions	OpsFlightRow[]	Delayed/cancelled flights, soonest first.

ChangeResult

Result of changing a segment.

Fields

reservation	Reservation	Updated reservation.
fareDifference	number	Amount actually charged (positive) or credited (negative); 0 when waived.
waivedFareDifference	number	Fare difference waived due to an airline disruption (0 otherwise).
reason	string	voluntary \| airline_disruption (a protected rebooking waives the fare difference).
currency	string	Currency code.

ChangePreview

Read-only quote of a flight change (no commit) — the fare difference and reason before you change.

Fields

segmentId	string	Segment that would change.
fromCabin	string	Current cabin.
toCabin	string	Cabin after the change.
newFlightId	string	Target flight id.
newFlightNumber	string	Target flight number.
fareDifference	number	Amount that would be charged (0 when waived).
waivedFareDifference	number	Amount waived due to an airline disruption.
reason	string	voluntary \| airline_disruption.
currency	string	Currency code.
summary	string	Plain-English quote.

CancelPreview

Read-only quote of a cancellation (no commit) — refund vs. travel credit and reason before you cancel.

Fields

refundAmount	number	Amount that would be refunded to original payment.
travelCredit	number	Amount that would be issued as travel credit.
refundable	boolean	true if any cash refund would be due.
reason	string	within_24h_of_booking \| airline_disruption \| refundable_fare \| non_refundable_credit \| mixed.
within24HourGracePeriod	boolean	true if within 24h of booking (full refund).
currency	string	Currency code.
summary	string	Plain-English quote.

CancelResult

Result of cancelling a reservation.

Fields

reservation	Reservation	Cancelled reservation.
refundAmount	number	Refunded to original payment.
travelCredit	number	Issued as travel credit (non-refundable fares outside grace/disruption).
refundable	boolean	true if any refund was due.
reason	string	within_24h_of_booking \| airline_disruption \| refundable_fare \| non_refundable_credit \| mixed.
within24HourGracePeriod	boolean	true if cancelled within 24h of booking (full refund).
travelCreditCode	string?	Code of the travel credit issued to the member's wallet, if any.
currency	string	Currency code.

SeatAssignResult

Result of assigning a seat.

Fields

reservation	Reservation	Updated reservation.
seat	Seat	The assigned seat.
segmentId	string	Segment affected.
passengerId	string	Passenger affected.
feeCharged	number	Preferred-seat fee charged (0 for standard seats or waived elites).
feeWaived	boolean	true if a preferred-seat fee was waived by tier.
feeWaivedReason	string?	Why the fee was waived.

CheckInResult

Result of checking in.

Fields

reservation	Reservation	Updated reservation.
segmentId	string	Segment checked in.
boardingPasses	BoardingPass[]	Boarding passes issued.

PerBagFee

The fee breakdown for one checked bag by its absolute position.

Fields

position	integer	Absolute bag position for this passenger (1-indexed).
itemType	string	standard \| sporting_equipment \| musical_instrument \| firearm \| pet.
baseFee	number	Position fee ($0 if within the free allowance; flat $200 for a cargo pet).
overweightFee	number	Overweight surcharge (51–100 lb).
oversizeFee	number	Oversize surcharge (63–115 linear in; waived for sporting equipment).
refused	boolean	true if the bag exceeds 100 lb or 115 in and was refused.
totalFee	number	Base + overweight + oversize for this bag.
note	string?	Handling note for special item types (firearm case, pet, etc.).

BaggageResult

Result of adding baggage, with the free-bag entitlement applied and a per-bag fee breakdown.

Fields

reservation	Reservation	Updated reservation.
bagsAdded	integer	Bags added in this call.
totalBags	integer	Total bags for the passenger on the segment.
charge	number	Amount charged (equals feeChargedUsd).
feeChargedUsd	number	Total fee charged for this call.
includedBags	integer	Effective free-bag allowance (best of fare vs tier).
includedBagsSource	string	fare \| tier — which allowance won.
overweightFee	number	Total overweight surcharge across the added bags.
oversizeFee	number	Total oversize surcharge across the added bags.
perBagFees	PerBagFee[]	Per-bag fee breakdown.
currency	string	Currency code.

BaggageFeeSchedulePerBag

One row of the position-based checked-bag fee table.

Fields

position	integer	Bag position (1, 2, or 3 for 3rd+).
feeUsd	number	Fee for a bag at this position, per direction.
label	string	Human label, e.g. "1st checked bag".

BaggageFeeSchedule

The single current checked-bag fee schedule (no effective dates); the website, API, and KB read these same numbers.

Fields

currency	string	Currency code (USD).
perBag	BaggageFeeSchedulePerBag[]	Position-based base fees.
perDirection	boolean	true — fees are per direction, not round trip.
overweight	object	{ appliesFromLbs, maxLbs, feeUsd, refusedOverLbs }.
oversize	object	{ appliesFromLinearInches, maxLinearInches, feeUsd, refusedOverLinearInches }.
notes	string	How the fee is applied.
summary	string	Plain-English fee summary.

UpgradeResult

Result of a cabin upgrade.

Fields

reservation	Reservation	Updated reservation.
upgraded	boolean	true if upgraded.
fromCabin	string	Original cabin.
toCabin	string	New cabin.
method	string	complimentary \| miles \| miles_plus_money \| paid.
milesUsed	integer	Miles redeemed (0 unless method=miles or miles_plus_money).
charge	number	Cash charged (fare difference for paid, or the copay for miles_plus_money; 0 otherwise).
currency	string	Currency code.

Health

Service liveness and store size.

Fields

status	string	"ok".
generatedAt	string	ISO time the timetable was seeded.
flights	integer	Flights in the store.
reservations	integer	Reservations in the store.

Destination

A nonstop destination reachable from an origin, with a from-price.

Fields

code	string	Destination airport code.
city	string	Destination city.
country	string	Destination country.
international	boolean	true if crossing a border from the origin.
fromPrice	number	Lowest economy fare on an upcoming nonstop.
currency	string	Currency code.

TravelCredit

A travel credit certificate in a member's wallet (issued on cancellation).

Fields

code	string	Certificate code (redeem at checkout).
pin	string	Certificate PIN.
amount	number	Original amount issued.
amountRemaining	number	Amount still available.
currency	string	Currency code.
issuedAt	string	ISO issue instant.
expiresAt	string	ISO expiry (12 months from issue).
sourcePnr	string	The cancelled booking it came from.

Wallet

A member's travel-credit wallet.

Fields

memberId	string	Member number.
credits	TravelCredit[]	Credit certificates.
totalRemaining	number	Sum of remaining balances.
currency	string	Currency code.

ResetResult

Result of resetting demo data.

Fields

generatedAt	string	ISO time of the fresh seed.
flights	integer	Flights seeded.
reservations	integer	Reservations seeded.

Lounge

A Meridian Lounge location.

Fields

id	string	Lounge id.
airportCode	string	Airport code.
city	string	City.
name	string	Lounge name.
location	string	Terminal/concourse location.
hoursOpen	string	Local opening time (HH:MM).
hoursClose	string	Local closing time (HH:MM).
dayPassAvailable	boolean	true if day passes are sold here.
international	boolean	true for an international-gateway lounge.

LoungeEligibility

Precomputed lounge-access decision for a passenger on a segment.

Fields

eligible	boolean	true if complimentary access applies (no pass needed).
method	string	membership \| paid_award_first \| paid_award_business_intl \| day_pass_required \| upgrade_pass_only \| none.
guestAllowance	integer	Guests the entitlement admits.
dayPassPriceUsd	number?	Price if a day/upgrade pass is the path in, else null.
loungesOnItinerary	object[]	Lounges at airports on this itinerary ({airportCode, name, location}).
reason	string	Plain-English explanation of the decision.

LoungePassPurchase

A purchased single-entry lounge pass.

Fields

id	string	Pass id.
pnr	string	Reservation.
passengerId	string	Passenger.
airportCode	string	Lounge airport.
loungeName	string	Lounge name.
type	string	day_pass ($65) \| upgrade_pass ($35).
priceUsd	number	Price charged.
purchasedAt	string	ISO purchase instant.

LoungeMembershipStatus

A member's lounge membership.

Fields

memberId	string	Member number.
membership	object	{tier: none\|standard\|lounge_plus, purchasedAt?, expiresAt?, autoRenew?}.

UpgradeQuoteMethod

One available upgrade method with its cost.

Fields

method	string	complimentary \| miles \| miles_plus_money \| paid.
available	boolean	true if seats are available for this method.
milesCost	integer?	Miles required (miles_plus_money).
copayUsd	number?	Cash copay (miles_plus_money).
chargeUsd	number?	Fare difference (paid).
clearsAt	string?	When a complimentary upgrade starts clearing.
note	string	Plain-English description.

UpgradeQuote

All upgrade options for a segment.

Fields

segmentId	string	Segment.
fromCabin	string	Current cabin.
targetCabin	string	Target cabin.
distanceMiles	integer	Segment distance (drives banding).
methods	UpgradeQuoteMethod[]	Available upgrade methods.
summary	string	Plain-English summary.

AwardQuote

A distance-/region-based 'starting at' award price.

Fields

origin	string	Origin code.
destination	string	Destination code.
cabin	string	Cabin.
distanceMiles	integer	Route distance.
pointsRequiredFrom	integer	Starting-at miles.
taxesFeesFromUsd	number	Starting-at taxes/fees.
currency	string	Currency code.
summary	string	Plain-English summary.

DisruptionCareEligibility

Authoritative per-passenger, per-segment disruption-care flags (answer from these, not from the rule prose).

Fields

segmentId	string	Segment.
passengerId	string	Passenger.
tier	string	Meridian tier used in the computation.
disrupted	boolean	true if the segment's flight is delayed or cancelled.
controllable	boolean	true if the disruption is airline-controlled.
delayMinutes	integer	Current delay minutes.
cancelled	boolean	true if the flight is cancelled.
mealVoucherEligible	boolean	3h+ (or cancel), controllable, Silver+.
hotelEligible	boolean	Controllable overnight (cancel or 4h+).
groundTransportEligible	boolean	Same basis as hotel.
loungePassEligible	boolean	Controllable disruption.
complimentaryUpgradeEligible	boolean	Platinum, or 6h+ controllable.
reason	string	Plain-English explanation.

ServiceRecoveryOffer

A goodwill gesture issued for an airline-controlled disruption.

Fields

id	string	Offer id.
pnr	string	Reservation.
segmentId	string	Segment.
type	string	lounge_pass \| meal_voucher \| discount_code \| miles_credit.
amountUsd	number?	Cash value where applicable.
milesAmount	integer?	Miles value where applicable.
issuedAt	string	ISO issue instant.
reason	string	Why it was issued.

DeniedBoardingResult

A denied-boarding / oversold event with server-computed compensation (DOT/APPR).

Fields

id	string	Event id.
pnr	string	Reservation.
passengerId	string	Passenger.
flightId	string	Flight.
type	string	voluntary \| involuntary.
arrivalDelayMinutes	integer	Delay to the passenger's arrival.
compensationType	string	cash \| voucher.
compensationAmount	number	Computed amount (capped per rule).
currency	string	USD or CAD.
reason	string	Plain-English explanation of the calculation.

SpecialServiceRequest

A special-service request (accessibility, animals, pets, medical, UM).

Fields

id	string	SSR id.
passengerId	string	Passenger.
segmentId	string?	Segment, if scoped to one.
type	string	wheelchair \| service_animal \| pet_cabin \| poc_oxygen \| deaf_hard_of_hearing \| blind_low_vision \| allergy \| unaccompanied_minor.
status	string	requested \| confirmed \| denied.
feeUsd	number	Fee ($0 for accessibility; $100 cabin pet).
requestedAt	string	ISO request instant.
details	object?	Type-specific details (animal, device, guardian, etc.).

UnaccompaniedMinorResult

Registered Unaccompanied Minor service.

Fields

pnr	string	Reservation.
passengerId	string	The minor.
feeUsd	number	UM fee ($50 for ages 5–12, unless waived).
waived	boolean	true if waived for a Gold/Platinum guardian.
guardianContact	object	Drop-off / pickup contacts.
ssr	SpecialServiceRequest	The underlying UM special-service record.

FamilySeatingResult

Result of auto-assigning adjacent family seats.

Fields

pnr	string	Reservation.
segmentId	string	Segment.
adjacencyMet	boolean	true if adjacent seats were found and assigned.
assignments	object[]	{passengerId, seat} for each assigned passenger.

BaggageClaim

A filed baggage claim.

Fields

fileId	string	Claim file id.
passengerId	string	Passenger.
segmentId	string	Segment.
type	string	delayed \| damaged \| lost \| left_on_board.
status	string	open \| located \| closed.
filedAt	string	ISO filing instant.
liabilityCapUsd	number	Applicable liability cap ($4,700 domestic / ~$2,100 international).

CarryOnPolicy

Carry-on / personal-item / lithium-battery reference policy for an aircraft type.

Fields

aircraft	string	Aircraft type.
carryOn	object	{count, maxLinearInches, maxWeightLbs, free}.
personalItem	object	{count, maxDimensionsInches, free}.
gateCheckLikely	boolean	true on regional aircraft where roller bags are gate-checked.
lithiumBattery	object	Spare-battery rules by watt-hour.
summary	string	Plain-English summary.

Example

curl -H "x-api-key: agentic-demo-key" \
  "https://agenticairways.ai/api/reservations/JETSET?lastName=Rivera"