> ## 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.

# AI Explanation

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

<Warning>
  The `/api/explain` public endpoint is coming soon. During private beta, AI explanations are available via the [Risk Score](/api-reference/score) endpoint by passing a request through the web app, or by using the app's built-in explain panel.
</Warning>

## Overview

The AI explanation feature generates a plain-language summary of the main delay risk factors for a flight. It covers historical performance, weather outlook, airport congestion, seasonal patterns, and airline-specific reliability.

Powered by Claude (Anthropic).

## How to access it now

The explanation is generated on-demand in the app UI when you open the detail panel for any flight score. A standalone API endpoint for programmatic access will be available in the next release.

## Planned request parameters

<ParamField query="origin" type="string" required>
  IATA code of the departure airport.
</ParamField>

<ParamField query="dest" type="string" required>
  IATA code of the arrival airport.
</ParamField>

<ParamField query="airline" type="string" required>
  IATA airline code.
</ParamField>

<ParamField query="date" type="string" required>
  Departure date in `YYYY-MM-DD` format.
</ParamField>

<ParamField query="api_key" type="string" required>
  Your API key.
</ParamField>

## Planned response

```json Response theme={null}
{
  "origin": "FCO",
  "destination": "LHR",
  "airline": "AZ",
  "date": "2026-04-10",
  "score": 62,
  "label": "High",
  "explanation": "ITA Airways on the Rome Fiumicino → London Heathrow route has a historical delay rate of 31%, above the European average. April sees elevated congestion at Heathrow due to school holiday traffic. The main risk factors are historical airline performance and destination airport congestion."
}
```

<Note>
  To be notified when this endpoint goes live, [contact us](mailto:hello@airrating.io) or watch the [changelog](https://airrating.io).
</Note>