Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.airrating.io/llms.txt

Use this file to discover all available pages before exploring further.

​
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

ScoreLabelWhat it means
0–30Low riskLow historical delay rate, good conditions
31–60Medium riskModerate delay probability, book with awareness
61–80High riskElevated risk, consider alternatives or buffer time
81–100Very high riskHigh 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.