API Documentation

AirAPI provides type-safe, serverless travel data endpoints. All endpoints return JSON responses and are designed for predictable integration.

Base URL

https://airapi.space

Format

JSON

Authentication

None (public beta)

Getting Started

All endpoints are accessible via HTTPS. No API key is required during the beta period. Here's a quick example:

# Check if a direct route exists between Sydney and Melbourne
curl https://airapi.space/api/routes/exists \
  -G \
  -d "origin=SYD" \
  -d "dest=MEL"

// Response: 200 OK
{
  "status": "success",
  "message": "Direct Routes Found",
  "results": [
    {
      "origin": "SYD",
      "destination": "MEL",
      "carriers": ["JQ", "QF", "CI"],
      "distanceKm": 707,
      "durationMin": 95
    }
  ]
}

Beta notice

AirAPI is in active development. 16 endpoints are live today; 42 more are planned across 8 categories.

Endpoint Stability Progression

Each endpoint progresses through three stability tiers based on real-world usage volume, verified via API telemetry and request analytics. Progression is tracked per-endpoint — each endpoint's unique request count is measured independently.

Alpha New endpoints — may change behavior without notice. → Beta at 1M unique requests

Beta Behavior is locked; minor refinements only. → Stable at 10M unique requests

Stable Production-ready — no breaking changes. Fully reliable for critical integrations.

Endpoint Reference

The full catalog of planned and live API endpoints.

Live Implementing Planned

Route & Pathfinding

alpha

NBA* multi-hop search across global route networks

5 live

Airport, Airline & Aircraft

alpha

Comprehensive aviation reference catalogs with IATA/ICAO conversion

11 live 3 planned

Geo & Distance

alpha

Haversine distance, bearing, arc calculations between airports

6 planned

Fare & Pricing

alpha

Tax-inclusive fare quoting, ATPCO rules, holiday surcharges

10 planned

NDC Shopping

alpha

New Distribution Capability offer search and flight shopping

3 planned

Schedule & Availability

alpha

Flight schedule lookup, DOOP patterns, availability, holiday calendars

7 planned

Operations

alpha

Delay propagation, disruption rebooking, crew compliance checks, flight tracking

7 planned

Date & Time

alpha

Timezone utilities, connection validation, DST checks

6 planned

Development Roadmap

Tier 1 Core differentiators

Route pathfinding / existence / search, fare quote with taxes, NDC offer search, airline/airport/aircraft reference lookups, health check

Tier 2 Agency / broker value-add

Baggage fee calculator, schedule lookup + availability, aircraft estimation (flight time, fuel), holiday-aware calendars, airport geo utilities

Tier 3 Operational / enterprise

Delay propagation / disruption rebooking, crew tracking.

All 58 endpoints are designed and type-checked. Deployment cadence depends on testing coverage and operational readiness.