Flight disruption stats for a specific airline, origin, or destination airport via FlightAware — $0.01/request.
What it does
This endpoint returns disruption statistics (delays, cancellations, total flights, and a disruption score) for a specific entity identified by type and ID. The entity_type path parameter accepts "airline", "origin", or "destination", and the id path parameter is the corresponding IATA/ICAO code (e.g., "UAL" for United Airlines, "KJFK" for JFK airport). An optional time_period query parameter filters results to today, yesterday, last3days, last7days, last14days, or last30days.
The endpoint is part of StableTravel, a pay-per-request travel API gateway that proxies FlightAware AeroAPI data. It costs $0.01 per call, paid via MPP (Tempo method on chain 4217) or x402 protocol using USDC. No API keys or subscriptions are required — payment serves as authentication. The response includes entity_type, entity_id, name, delays count, cancellations count, total flights, and a disruption score.
This is a GET endpoint. The URL pattern is /api/flightaware/disruption-counts/{entity_type}/{id} where both entity_type and id are path segments. The companion endpoint /api/flightaware/disruption-counts/{entity_type} returns disruption stats across all entities of a given type, also at $0.01 per request.
Capabilities
Use cases
- —Check how many flights a specific airline has delayed or cancelled over the last 7 days
- —Monitor disruption levels at a departure or arrival airport before booking
- —Build dashboards comparing airline reliability scores over time
- —Alert agents or users when disruption scores exceed a threshold
- —Evaluate airport operational health for travel planning
Fit
Best for
- —AI travel agents needing real-time airline/airport reliability data
- —Operations teams monitoring flight disruption trends
- —Travel apps displaying delay and cancellation statistics for airports or airlines
Not for
- —Booking flights or hotels (use other StableTravel endpoints for that)
- —Real-time individual flight tracking (use /flightaware/flights/{id}/position instead)
- —Historical per-flight delay data (use /flightaware/history/ endpoints)
Quick start
# Get disruption stats for United Airlines over the last 7 days
npx agentcash fetch "https://stabletravel.dev/api/flightaware/disruption-counts/airline/UAL?time_period=last7days"Example
Response
{
"name": "United Air Lines Inc.",
"score": 11.3,
"total": 14200,
"delays": 1523,
"entity_id": "UAL",
"entity_type": "airline",
"cancellations": 87
}Endpoint
Quality
Full OpenAPI 3.1 schema with response shape, clear pricing ($0.01 USD), documented parameters (entity_type, id, time_period), and a live 402 MPP challenge confirming the endpoint is operational. Minor deduction because no example response was provided in the spec — the example_response_json above is inferred from the schema.
Warnings
- —Example response is inferred from the OpenAPI schema, not captured from a live call.
- —The MPP challenge amount of 10000 base units on currency 0x20c000…b50 (chain 4217) could not be independently verified for decimals; the OpenAPI x-payment-info states $0.01 USD.
Citations
- —Endpoint price is $0.01 per requesthttps://stabletravel.dev/openapi.json
- —entity_type accepts airline, origin, or destination; time_period accepts today, yesterday, last3days, last7days, last14days, last30dayshttps://stabletravel.dev/openapi.json
- —Response includes entity_type, entity_id, name, delays, cancellations, total, and score fieldshttps://stabletravel.dev/openapi.json
- —Payment via USDC on Base, Solana, or Tempo (x402/MPP protocol) serves as authenticationhttps://stabletravel.dev
- —Endpoint is live — 402 MPP challenge returned on HEAD requesthttps://stabletravel.dev/api/flightaware/disruption-counts/:entity_type/:id