Check GDS flight availability via Amadeus — $0.03/request, no API keys, pay with USDC
What it does
This endpoint queries Amadeus GDS flight availability data via a POST request. It returns seat availability by cabin class for specified origin-destination pairs, travelers, and dates. The request body accepts `originDestinations` (with IATA codes and departure dates), `travelers` (typed as ADULT, CHILD, etc.), `sources` (GDS), and optional `searchCriteria` for carrier/cabin/connection filters. The response includes an array of availability results with dictionaries and metadata.
This is one endpoint within the broader StableTravel API suite, which provides pay-per-request access to flights (search, price, book, seatmaps, upsells, status), hotels (list, search, book, ratings), activities, airport transfers, reference data, real-time flight tracking via FlightAware AeroAPI, and Google Flights price comparison. All endpoints use the same payment model: no API keys, no OAuth, no subscriptions. Payment is handled automatically via x402/MPP protocol using USDC on Base, Solana, or Tempo. This specific availability endpoint costs $0.03 per call.
The availability endpoint differs from the flight search endpoint in that it focuses on seat inventory and cabin-level availability rather than priced offers. It supports advanced filtering including carrier restrictions, cabin restrictions with origin-destination scoping, connection limits, and the option to include closed content or exclude allotments. Typical workflow: use availability to check seat inventory, then use /flights/search for priced offers, /flights/price to confirm pricing, and /flights/book to complete the booking.
Capabilities
Use cases
- —Check real-time seat availability by cabin class before pricing a flight offer
- —Verify inventory on specific carriers for a multi-city itinerary
- —Filter available flights by connection limits and cabin restrictions for travel agent automation
- —Confirm seat availability across GDS before proceeding to booking workflow
- —Build autonomous travel agents that check availability before committing to bookings
Fit
Best for
- —AI travel agents that need GDS-level seat inventory data
- —Programmatic flight booking workflows requiring availability confirmation before pricing
- —Multi-city or complex itinerary planning with cabin and carrier constraints
Not for
- —Price comparison shopping (use /google-flights/search or /flights/search instead)
- —Real-time flight tracking or position data (use FlightAware endpoints)
- —Hotel, activity, or transfer searches (use respective StableTravel endpoints)
Quick start
npx agentcash fetch -X POST -H "Content-Type: application/json" \
-d '{"originDestinations":[{"id":"1","originLocationCode":"JFK","destinationLocationCode":"LAX","departureDateTime":{"date":"2025-07-15"}}],"travelers":[{"id":"1","travelerType":"ADULT"}],"sources":["GDS"]}' \
"https://stabletravel.dev/api/flights/availability"Example
Request
{
"sources": [
"GDS"
],
"travelers": [
{
"id": "1",
"travelerType": "ADULT"
}
],
"searchCriteria": {
"flightFilters": {
"cabinRestrictions": [
{
"cabin": "BUSINESS",
"originDestinationIds": [
"1"
]
}
]
}
},
"originDestinations": [
{
"id": "1",
"departureDateTime": {
"date": "2025-07-15"
},
"originLocationCode": "JFK",
"destinationLocationCode": "LAX"
}
]
}Response
{
"data": [
{
"id": "1",
"type": "flight-availability",
"source": "GDS",
"segments": [
{
"number": "1",
"arrival": {
"at": "2025-07-15T11:30:00",
"iataCode": "LAX"
},
"departure": {
"at": "2025-07-15T08:00:00",
"iataCode": "JFK"
},
"carrierCode": "AA",
"availabilityClasses": [
{
"class": "J",
"numberOfBookableSeats": 4
},
{
"class": "Y",
"numberOfBookableSeats": 9
}
]
}
],
"originDestinationId": "1"
}
],
"meta": {},
"dictionaries": {}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response types, clear pricing ($0.03/call), extensive guidance documentation, and well-documented parameters. The endpoint returned 405 on HEAD/GET probes which is expected since it's POST-only — not an indication of being down. No live 402 challenge was captured for this specific endpoint, but the broader API is clearly live (root returns 200) and pricing is documented in x-payment-info.
Warnings
- —Probe returned 405 on HEAD and GET because this is a POST-only endpoint; no 402 MPP challenge was directly captured for this path
- —Example response is inferred from Amadeus availability patterns and the OpenAPI schema — no actual response sample was provided in the docs
- —The hotels/ratings endpoint is listed in the OpenAPI but not included in the probe paths
Citations
- —Flight availability endpoint costs $0.03 per requesthttps://stabletravel.dev/openapi.json
- —Payment via USDC on Base, Solana, or Tempo using x402/MPP protocol with no API keys neededhttps://stabletravel.dev
- —Endpoint accepts POST with originDestinations, travelers, and sources as required fieldshttps://stabletravel.dev/docs
- —Part of broader StableTravel suite covering flights, hotels, activities, transfers, FlightAware, and Google Flightshttps://stabletravel.dev