Skyfare

get_member_profileread

The signed-in member: name, loyalty number, tier and its benefits, miles balance, saved payment cards (card_id) and saved companions (traveler_id) who can be booked.

list_bookingsread

List the member's bookings with record locators, routes, dates, passengers, cabin, fare family and check-in status. status: upcoming (default), past, cancelled or all.

get_bookingread

Full details of one booking: status, when it was booked (and whether 24-hour free cancellation still applies), fare family and its rules, flights with live status, passengers (passenger_id, seats, checked bags, check-in, special-service requests), check-in window, any disruption remedies, and every payment. Fails with not_found for an unknown locator.

search_flightsread

Search Skyfare's published schedule (2026-05-11 to 2026-05-20) for nonstop and one-stop itineraries departing on a local date. Times are local to each airport, with their UTC offset. Connections are between 45 min and 6 h. Each itinerary lists flight_ids, per-passenger and total prices and seats left for every fare family in the cabin, and award (miles) prices. Cancelled flights and flights leaving within 90 minutes are not shown. Fails with unknown_airport or invalid_date.

get_flightread

Live status and details of one flight: scheduled and estimated local times, delay minutes or cancellation, aircraft, seats left per cabin and fare family, award seats, and its check-in window. Fails with not_found.

get_seat_mapread

Seat map for one cabin of a flight, row by row: which seats are available, occupied or blocked, which seats the member's travelers hold, seat positions (window/middle/aisle per letter), exit rows and extra-legroom rows with their fee. Seats in the same block with neighbouring letters are side by side; blocks are separated by aisles. Fails with not_found.

get_fare_rulesread

Fare rules for Basic, Standard and Flex (changes, refunds, seat selection, bags) plus general policies: the 24-hour rule, check-in window, connections, disruptions, name corrections, special meals, travel credits and awards. With a locator, also explains what applies to that booking now.

quote_changeread

Price a change before making it: per-passenger change fee and fare difference, the total, and any disruption waiver. Same checks as change_flight (basic_no_changes, award_no_changes, checked_in, different_route, same_itinerary, sold_out, connection_too_short…). The quoted total is exactly what change_flight charges.

quote_cancellationread

What cancelling a booking would return right now, under its fare rules and the 24-hour rule: the allowed refund_method options with amounts and where the money goes, plus fees, forfeited fare and non-refundable extras. Fails with booking_cancelled, flight_departed or checked_in.

list_travel_creditsread

The member's Skyfare travel credits: credit_id, remaining balance, original amount, expiry (expired credits can't be used) and where each came from.

get_boarding_passread

Boarding pass for a checked-in passenger: flight, seat, gate, boarding time, group and sequence number. Omit flight_id for every flight on the booking. Fails with not_checked_in before check-in.

list_messagesread

The member's in-app inbox, newest first: flight alerts, booking confirmations and other messages with sender, subject, body and any related record locator.

create_bookingwrite

Book a one-way itinerary (one nonstop flight or two connecting flights from search_flights) for the member and/or saved companions. Cash fares: the total is the quoted per-passenger fare × passengers; travel credits in payment.travel_credit_ids are applied first in the order given, the rest is charged to payment.card_id. Award tickets (payment.use_miles): miles per passenger from search, taxes on payment.card_id, issued as Standard. Fails with not_found, unknown_traveler, duplicate_traveler, fare_not_offered, sold_out, no_award_space, insufficient_miles, credit_expired, credit_empty, payment_required, invalid_payment, connection_too_short, too_late_to_book or flight_cancelled.

change_flightwrite

Move a booking to other flights on the same route (and optionally another cabin). Standard: $75 per passenger plus any fare difference. Flex: fare difference only. Basic and award tickets can't be changed. A lower new fare is not refunded. If a flight on the booking is cancelled or delayed 180+ minutes (and no voucher was taken for it), rebooking in the same cabin is free. Seats and special-service requests on replaced flights are removed. Charges card_id (default: the booking's card). Run quote_change first; the same failure codes apply.

cancel_bookingwrite

Cancel a whole booking. refund_method must be one of the options quote_cancellation offers: original_payment (24-hour rule, Flex, award), travel_credit (Standard: fare minus $75 per passenger; also allowed for Flex and the 24-hour rule) or none (Basic after 24 hours: the fare is forfeited). Fails with refund_not_allowed (listing the allowed methods), booking_cancelled, flight_departed or checked_in. Cancelling can't be undone.

request_compensationwrite

Claim the remedy for a disrupted flight on a booking. delay_voucher: flight delayed 180+ minutes; issues a $150 travel credit per passenger and keeps the booking (it then can't also be rebooked for free). cancellation_refund: flight cancelled by Skyfare; cancels the booking and refunds everything to the original payment. One remedy per flight. Fails with not_on_booking, not_eligible, already_compensated or booking_cancelled. For free rebooking use change_flight instead.

select_seatswrite

Assign seats on one flight of a booking. Each seat must be in the booking's cabin and available (or held by another passenger in this same request). Basic passengers can only choose after they have checked in. Extra-legroom seats charge their fee to card_id (default: the booking's card); other seats are free. Fails with basic_seat_selection, unknown_seat, wrong_cabin, seat_taken, seat_blocked, duplicate_seat, not_on_booking, passenger_not_found or too_late.

add_bagswrite

Add checked bags for one passenger (at most 3 per passenger). Fees per bag: $35 first, $50 second, $125 third; the first is free on Flex, in Premium/Business and for the Silver member themself (not companions). Fees are charged to card_id (default: the booking's card) and are non-refundable. Fails with bag_limit, too_late, passenger_not_found or booking_cancelled.

add_special_servicewrite

Add a special-service request for one passenger. Meals (VGML vegetarian/vegan, GFML gluten-free, KSML kosher, DBML diabetic, CHML child): one per passenger per flight, at least 24 hours before departure, only on flights of 4+ hours. Assistance: WCHR (can walk to the seat and use steps, not long distances), WCHS (can't use steps), WCHC (can't walk), BLND, DEAF. Without flight_id the request applies to every eligible flight on the booking. Fails with no_meal_service, too_late, meal_exists, duplicate_request, not_on_booking or passenger_not_found.

update_passengerwrite

Correct a typo in a passenger's name. The corrected full name may differ from the name as originally booked by at most 3 characters (letters added, removed or changed); a different person can't be put on the ticket. Not possible after check-in. Fails with name_change_not_allowed, invalid_name, no_change, checked_in or passenger_not_found.

check_inwrite

Check passengers in for every flight on a booking. Check-in opens 24 hours before the scheduled departure of the first flight and closes 60 minutes before departure. Passengers without a seat are given one (the rearmost free standard seat). Fails with checkin_not_open (says when it opens), checkin_closed, already_checked_in, flight_cancelled or passenger_not_found.