{"uid":"cap_ci_il29vOMGlBJ86uG65S","slug":"stabletravel-dev-seats-aero-award-availability-search-edd87f19","name":"stabletravel.dev Seats.aero Award Availability Search","description":"Search cached Seats.aero award availability by origin, destination, dates, cabin, carriers, and pagination.","url":"https://stabletravel.dev/api/seats-aero/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["origin_airport","destination_airport"],"properties":{"skip":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Number of results to skip"},"take":{"type":"integer","maximum":1000,"minimum":10,"description":"Number of results to return, 10 to 1000"},"cabin":{"enum":["economy","premium","business","first"],"type":"string","description":"Award cabin to require"},"cursor":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Cursor from a previous Seats.aero response"},"carriers":{"type":"string","description":"Comma-delimited carrier filter, e.g. \"UA,LH\"."},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Latest departure date"},"order_by":{"enum":["lowest_mileage"],"type":"string","description":"Order results by cheapest mileage instead of default date order"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Earliest departure date"},"include_trips":{"type":"boolean","description":"Include trip-level details in cached search results"},"origin_airport":{"type":"string","minLength":3,"description":"Origin airport list. Comma-delimit multiple codes, e.g. \"SFO,LAX\"."},"destination_airport":{"type":"string","minLength":3,"description":"Destination airport list. Comma-delimit multiple codes, e.g. \"FRA,LHR\"."},"only_direct_flights":{"type":"boolean","description":"Only return results with direct award availability"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"data":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"ID":{"anyOf":[{"type":"string"},{"type":"null"}]},"Date":{"anyOf":[{"type":"string"},{"type":"null"}]},"Route":{"anyOf":[{"type":"object","properties":{"ID":{"anyOf":[{"type":"string"},{"type":"null"}]},"Source":{"anyOf":[{"type":"string"},{"type":"null"}]},"Distance":{"anyOf":[{"type":"number"},{"type":"null"}]},"NumDaysOut":{"anyOf":[{"type":"number"},{"type":"null"}]},"OriginRegion":{"anyOf":[{"type":"string"},{"type":"null"}]},"OriginAirport":{"anyOf":[{"type":"string"},{"type":"null"}]},"DestinationRegion":{"anyOf":[{"type":"string"},{"type":"null"}]},"DestinationAirport":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"Source":{"anyOf":[{"type":"string"},{"type":"null"}]},"FDirect":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"JDirect":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"RouteID":{"anyOf":[{"type":"string"},{"type":"null"}]},"WDirect":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"YDirect":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"CreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"FAirlines":{"anyOf":[{"type":"string"},{"type":"null"}]},"JAirlines":{"anyOf":[{"type":"string"},{"type":"null"}]},"UpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"WAirlines":{"anyOf":[{"type":"string"},{"type":"null"}]},"YAirlines":{"anyOf":[{"type":"string"},{"type":"null"}]},"FAvailable":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"JAvailable":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"ParsedDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"WAvailable":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"YAvailable":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"FMileageCost":{"anyOf":[{"type":"string"},{"type":"null"}]},"JMileageCost":{"anyOf":[{"type":"string"},{"type":"null"}]},"WMileageCost":{"anyOf":[{"type":"string"},{"type":"null"}]},"YMileageCost":{"anyOf":[{"type":"string"},{"type":"null"}]},"FRemainingSeats":{"anyOf":[{"type":"number"},{"type":"null"}]},"JRemainingSeats":{"anyOf":[{"type":"number"},{"type":"null"}]},"WRemainingSeats":{"anyOf":[{"type":"number"},{"type":"null"}]},"YRemainingSeats":{"anyOf":[{"type":"number"},{"type":"null"}]},"AvailabilityTrips":{}},"additionalProperties":{}}},{"type":"null"}]},"count":{"anyOf":[{"type":"number"},{"type":"null"}]},"cursor":{"anyOf":[{"type":"number"},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}}}}}},"responseSchema":{"type":"json","example":{"data":[{"ID":"avail_123","Date":"2026-12-10","Route":{"Source":"united","OriginRegion":"North America","OriginAirport":"SFO","DestinationRegion":"Europe","DestinationAirport":"FRA"},"Source":"united","JDirect":true,"JAirlines":"UA","JAvailable":true,"JMileageCost":"88000","JRemainingSeats":2}],"count":1,"cursor":123456,"hasMore":true}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"take":50,"cabin":"business","carriers":"UA,LH","end_date":"2026-01-22","order_by":"lowest_mileage","start_date":"2026-01-15","include_trips":true,"origin_airport":"SFO,LAX","destination_airport":"LHR,FRA"}}},"response":{"data":[],"count":0,"cursor":1780633892,"hasMore":false}},"exampleRequest":{"take":50,"cabin":"business","carriers":"UA,LH","end_date":"2026-01-22","order_by":"lowest_mileage","start_date":"2026-01-15","include_trips":true,"origin_airport":"SFO,LAX","destination_airport":"LHR,FRA"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.92","successRate":"0.94","reviews":2,"stars":"4.7","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1572,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h8ZV5ekYwhdZumHjj6Cl6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search cached Seats.aero award flight availability by origin, destination, dates, cabin class, and carriers with pagination support.","exampleAgentPrompt":"Search Seats.aero's cached award availability for business class flights from SFO or LAX to LHR or FRA between January 15 and January 22, 2026, filtering to United and Lufthansa only, sorted by lowest mileage — show me up to 50 results and include trip details.","exampleUseCases":[{"title":"Find cheapest miles redemption to Europe","prompt":"I want to use my airline miles for a spring trip to Europe. Search for the cheapest award flights from any US West Coast airport to London, Paris, or Frankfurt in business class between March 1 and March 15, 2026 — just show me the lowest mileage options first."},{"title":"Compare first class availability across alliances","prompt":"Help me find first class award seats from New York to Tokyo for next October. Search across all carriers but focus on Star Alliance and Oneworld options, and let me know which airlines have the best mileage rates available."},{"title":"Check award seat inventory for honeymoon planning","prompt":"We're planning our honeymoon and want to fly premium cabin from JFK to both CDG and then FCO in late June 2026. Search for available award flights on the dates we need, show me direct flight options if possible, and tell me what the total mileage would be for the whole trip."}],"resultDescription":"Returns a paginated list of cached award availability records from Seats.aero including flight segments, cabin class, mileage costs, carrier information, and optionally trip-level details, along with a cursor for fetching the next page of results.","failureModes":["Missing required origin_airport or destination_airport returns validation error","Invalid date format (not YYYY-MM-DD) causes rejection","take value outside 10–1000 range returns error","Invalid cabin enum value returns error","No award availability found for the specified route/dates returns empty result set","Stale cache may not reflect real-time award space"],"whenToPreferThis":"Use this endpoint when you need to search for airline award/miles redemption availability across multiple carriers and routes using Seats.aero's aggregated cached data. Prefer this over live flight search APIs when the goal is finding mileage redemption opportunities rather than paid fares, especially when filtering by cabin class or specific alliance carriers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2951,"lastUsedAt":"2026-09-15T13:07:41.224Z","lastSuccessfullyRanAt":"2026-09-13T14:56:01.181Z","lastHealthCheckAt":"2026-09-14T22:42:00.168Z","isFirstParty":false}