/seats-aero

name: seats-aero
description: Search award flight availability across 27 mileage programs via Seats.aero Partner API. Find cheapest award flights, compare programs, and get booking links.
category: flights
summary: Award availability across 27 mileage programs.
api_key: Seats.aero Pro/Partner
license: MIT

Seats.aero Skill

Search cached and live award flight availability across 27 mileage programs (including Spirit Free Spirit and Frontier Miles, added April 2026). Find the cheapest award flights, compare programs, and get booking links.

**Source:** [seats.aero](https://seats.aero) | [API Docs](https://developers.seats.aero) | [Knowledge Base](https://docs.seats.aero)

Authentication

Set `SEATS_AERO_API_KEY` in your `.env` file. Get from [Settings > API tab](https://seats.aero/settings) (Pro account required).

All requests use the `Partner-Authorization` header. Pro users get **1,000 API calls per day** for non-commercial use.

API Base

https://seats.aero/partnerapi

Key Concepts

Saver vs Dynamic Pricing

Award seats fall into two categories:

• **Saver (fixed price):** Set, predictable miles cost. Often the ONLY type bookable through partner programs. Best value. Always shown on Seats.aero.
• **Dynamic:** Price changes based on demand (like cash fares). Can be reasonable or extremely expensive. Seats.aero **filters out overpriced dynamic awards by default.**

Dynamic Price Filter Thresholds

Awards exceeding these per-hour thresholds are hidden automatically:

| Program | Economy | Prem Econ | Business | First | |---------|---------|-----------|----------|-------| | American | <100K total | <100K total | <150K total | <200K total | | United | 7,500/hr | 10,000/hr | 14,000/hr | 20,000/hr (max 10h) | | Delta | 10,000/hr | 15,000/hr | 20,000/hr | N/A | | Aeroplan | 7,500/hr | 10,000/hr | 12,500/hr | 15,000/hr | | Flying Blue | 5,000/hr | 10,000/hr | 15,000/hr | 15,000/hr | | Alaska | <150K total | <150K total | <150K total | <150K total | | Aeromexico | 10,000/hr (max 10h) | 15,000/hr | 20,000/hr | N/A | | Etihad | 10,000/hr (max 10h) | 15,000/hr | 20,000/hr | N/A | | JetBlue | 10,000/hr | 15,000/hr | 20,000/hr | N/A | | Qantas | 7,500/hr | 10,000/hr | 20,000/hr | 25,000/hr |

To see ALL dynamic pricing (including expensive): pass `include_filtered=true` on cached search/bulk, or `disable_filters=true` / `show_dynamic_pricing=true` on live search.

Phantom Availability

Sometimes a flight shows bookable but no seat actually exists. Causes:

• **Cached/stale results:** Check `ComputedLastSeen` for freshness.
• **Syncing delays:** Seats taken but partner systems haven't updated.
• **Partner feed glitches:** Programs incorrectly show space on partners.

**Always verify on the airline's own site before transferring points.** Compare multiple programs in the same alliance. Call to confirm and hold if possible.

Foreign Program Caveats

Some programs (Smiles, TudoAzul, etc.) may require local tax IDs, local payment methods, or are only available in the local language. They still appear in results because they can serve as **signals**: if Azul TudoAzul shows United saver space, that same space is likely bookable through Aeroplan or other Star Alliance partners you CAN access.

Award Release Dates

Airlines release award seats at different advance windows (e.g., Aeroplan releases up to 358 days out). Check [seats.aero/tools/releases](https://seats.aero/tools/releases) to see the maximum days out for each airline by program. Useful for planning when to start searching.

Availability Objects

Each result from Cached Search / Bulk Availability is a **summary** that groups all flights for one route/date/program into a single object. For example, if Alaska shows 3 different SFO>LAX flights on Mar 16, they all appear in one availability object. The `MileageCost` fields show the **cheapest** option. The `RemainingSeats` fields show the **maximum** across all flights. Use Get Trips to see individual flight details.

Mileage Program Sources

| Source | Program | Cabins | Seat Count | Trip Data | Taxes | |--------|---------|--------|------------|-----------|-------| | `eurobonus` | SAS EuroBonus | Y/J | Yes | Yes | Yes | | `virginatlantic` | Virgin Atlantic Flying Club | Y/W/J | Yes | Yes | Yes | | `aeromexico` | Aeromexico Club Premier | Y/W/J | Yes | Yes | Yes | | `american` | American Airlines AAdvantage | Y/W/J/F | Low seats only* | Yes | Yes | | `delta` | Delta SkyMiles | Y/W/J | Yes | Yes | Yes | | `etihad` | Etihad Guest | Y/J/F | Yes | Yes | Yes | | `united` | United MileagePlus | Y/W/J/F | Yes | Yes | Yes | | `emirates` | Emirates Skywards | Y/W/J/F | No | Partial** | Yes | | `aeroplan` | Air Canada Aeroplan | Y/W/J/F | Usually*** | Yes | Yes | | `alaska` | Alaska Mileage Plan | Y/W/J/F | Yes | Yes | Yes | | `velocity` | Virgin Australia Velocity | Y/W/J/F | Yes | Yes | Yes | | `qantas` | Qantas Frequent Flyer | Y/W/J/F | No | Yes | Yes | | `connectmiles` | Copa ConnectMiles | Y/J/F | No | Yes | Yes | | `azul` | Azul TudoAzul | Y/J | No | Yes | Yes | | `smiles` | GOL Smiles | Y/W/J/F | Yes | Yes | Yes | | `flyingblue` | Air France/KLM Flying Blue | Y/W/J/F | Yes | Yes | Yes | | `jetblue` | JetBlue TrueBlue | Y/W/J/F | Yes | Yes | Yes | | `qatar` | Qatar Privilege Club | Y/J/F | No | Yes | No | | `turkish` | Turkish Miles & Smiles | Y/J | No | Yes | No | | `singapore` | Singapore KrisFlyer | Y/W/J/F | No | Yes | No | | `ethiopian` | Ethiopian ShebaMiles | Y/J | Yes | Yes | Yes | | `saudia` | Saudi AlFursan | Y/J/F | Yes | Yes | Yes | | `finnair` | Finnair Plus | Y/W/J/F | Yes | Yes | Yes | | `lufthansa` | Lufthansa Miles&More | Y/J/F | Yes | Yes | Yes | | `frontier` | Frontier Airlines | Y | No | Yes | Yes | | `spirit` | Spirit Airlines | Y | Yes | Yes | Yes |

\* AA provides seat counts only when remaining seats are low. Otherwise shows 0. \** Emirates connection flights may have missing fields. \*** Aeroplan seat count is typically availab