GET
$0.05 default
/api/seats-aero/availabilityDescription
Retrieve bulk cached Seats.aero award availability for a mileage program, optionally filtered by region, date, and cabin.
Pricing
$0.05 default
Parameters
{
"additionalProperties": false,
"properties": {
"cabin": {
"description": "Award cabin to require",
"enum": [
"economy",
"premium",
"business",
"first"
],
"type": "string"
},
"cursor": {
"description": "Cursor from a previous Seats.aero response",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"destination_region": {
"enum": [
"North America",
"South America",
"Africa",
"Asia",
"Europe",
"Oceania"
],
"type": "string"
},
"end_date": {
"description": "Latest departure date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"origin_region": {
"enum": [
"North America",
"South America",
"Africa",
"Asia",
"Europe",
"Oceania"
],
"type": "string"
},
"skip": {
"description": "Number of results to skip",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"source": {
"description": "Seats.aero mileage program source, such as united or aeroplan",
"minLength": 1,
"type": "string"
},
"start_date": {
"description": "Earliest departure date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"take": {
"description": "Number of results to return, 10 to 1000",
"maximum": 1000,
"minimum": 10,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
}Example response
{
"count": 1,
"cursor": 123456,
"data": [
{
"Date": "2026-12-10",
"ID": "avail_123",
"JAirlines": "UA",
"JAvailable": true,
"JDirect": true,
"JMileageCost": "88000",
"JRemainingSeats": 2,
"Route": {
"DestinationAirport": "FRA",
"DestinationRegion": "Europe",
"OriginAirport": "SFO",
"OriginRegion": "North America",
"Source": "united"
},
"Source": "united"
}
],
"hasMore": true
}