# StableTravel Seats.aero Award Availability

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

Search award flight availability by mileage program, route, cabin class, and date range using Seats.aero data

## Facts

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

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-seats-aero-award-availability-f590dee6
```

Example prompt: Can you check Seats.aero for available United business class award flights from North America to Europe departing between 2026-12-01 and 2026-12-31? Show me up to 50 results.

## When to prefer this

Use this endpoint when you need award seat availability data from Seats.aero for a specific mileage program without requiring authentication or a subscription. Ideal for agents searching award redemptions by cabin, date range, and region. Prefer over scraping loyalty program websites or requiring a Seats.aero API subscription.

## Known failure modes

- Missing required 'source' parameter returns 400 error
- Invalid cabin enum value rejected
- Invalid date format (not YYYY-MM-DD) rejected
- 'take' value outside 10-1000 range rejected
- No results found for the given source/date/region combination returns empty data array
- Payment failure via x402 protocol blocks request
- Rate limits or upstream Seats.aero outage may return 503

## How this service works

Retrieve bulk cached Seats.aero award availability for a mileage program, optionally filtered by region, date, and cabin.

## Output

Returns a paginated list of award availability records including route details (origin/destination airport and region), mileage program source, cabin availability flags, mileage cost, remaining seat count, direct flight indicator, and operating airlines. Also includes a cursor for pagination and a hasMore flag.

## 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": [
      "source"
     ],
     "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"
      },
      "source": {
       "type": "string",
       "minLength": 1,
       "description": "Seats.aero mileage program source, such as united or aeroplan"
      },
      "end_date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Latest departure date"
      },
      "start_date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Earliest departure date"
      },
      "origin_region": {
       "enum": [
        "North America",
        "South America",
        "Africa",
        "Asia",
        "Europe",
        "Oceania"
       ],
       "type": "string"
      },
      "destination_region": {
       "enum": [
        "North America",
        "South America",
        "Africa",
        "Asia",
        "Europe",
        "Oceania"
       ],
       "type": "string"
      }
     },
     "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"
    }
   }
  }
 }
}
```

## 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-seats-aero-award-availability-f590dee6/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)