Seats AeroCAUTION

AI-powered travel hacking and search with cash, points, miles, and award flights. Drop-in skills and MCP servers for Claude, Codex, and OpenCode.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
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

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (5)

.agents/skills

.claude/skills

.opencode/skills

skills

AGENTS.md

Gates applied: no_behavioural_pass.