Quickstart - AirRating

1. Get an API key

During private beta, API keys are provisioned manually. Contact [email protected] or join the waitlist at airrating.io. Once issued, your key looks like:

ar_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Never expose your API key in client-side code or public repositories.

2. Check the API health

Before making your first call, verify the API is up:

curl "https://app.airrating.io/api/health"

{
  "status": "ok",
  "time": "2026-03-21T10:00:00Z",
  "components": {
    "api": "ok",
    "database": "ok",
    "ml_model": "ok"
  }
}

3. Get your first Risk Score

curl "https://app.airrating.io/api/score?origin=FCO&dest=LHR&airline=AZ&date=2026-04-10&api_key=YOUR_API_KEY"

{
  "origin": "FCO",
  "destination": "LHR",
  "airline": "AZ",
  "date": "2026-04-10",
  "score": 62,
  "confidence": 0.84,
  "delay_rate": 0.31,
  "avg_delay_min": 28.4,
  "total_flights": 312,
  "label": "Medium risk",
  "explanation": "This route has a historical delay rate of 31%. Weather at Heathrow is a recurring factor in the April window. Medium confidence based on 312 recorded flights."
}

4. Understand the score

Score	Label	What it means
0–30	Low risk	Low historical delay rate, good conditions
31–60	Medium risk	Moderate delay probability, book with awareness
61–80	High risk	Elevated risk, consider alternatives or buffer time
81–100	Very high risk	High probability of significant delay

5. Explore other endpoints

Airlines on a route

Get all airlines operating a route with their individual risk scores.

AI explanation

Get a natural-language explanation of the risk drivers for a specific flight.

Route news

Get recent news and disruption reports for a route.

Key management

Validate your key, check usage, or create test keys.

​1. Get an API key

​2. Check the API health

​3. Get your first Risk Score

​4. Understand the score

​5. Explore other endpoints

Airlines on a route

AI explanation

Route news

Key management

1. Get an API key

2. Check the API health

3. Get your first Risk Score

4. Understand the score

5. Explore other endpoints