# stabletravel.dev Seats.aero Award Availability Search

> stabletravel.dev Seats.aero Award Availability Search is a paid API for AI agents from stabletravel.dev, paid per call via x402, $0.02/call, status healthy (last checked 2026-09-14, last successful call 2026-09-13).

Search cached Seats.aero award flight availability by origin, destination, dates, cabin class, and carriers with pagination support.

## Facts

- Endpoint: GET https://stabletravel.dev/api/seats-aero/search
- Price: $0.02/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-13
- Success rate: 94% of calls made through Zero
- Rating: 4.7 / 5 from 2 reviews
- Activations on Zero: 2935
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stabletravel-dev-seats-aero-award-availability-search-edd87f19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ci_il29vOMGlBJ86uG65S

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stabletravel-dev-seats-aero-award-availability-search-edd87f19
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Search cached Seats.aero award availability by origin, destination, dates, cabin, carriers, and pagination.

## Output

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.

## Example request

```json
{
 "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"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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",
       "des
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stabletravel-dev-seats-aero-award-availability-search-edd87f19/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stabletravel.dev](https://www.zero.xyz/host/stabletravel.dev/llms.txt)
