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

# Airlines on Route

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

## Overview

Returns a list of all airlines that operate a given route, each with their own Risk Score and historical delay statistics. Useful for comparing carriers before booking.

## Request

<ParamField query="origin" type="string" required>
  IATA code of the departure airport (e.g. `FCO`, `LHR`, `JFK`).
</ParamField>

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

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

## Response

<ResponseField name="origin" type="string">
  IATA code of the departure airport.
</ResponseField>

<ResponseField name="dest" type="string">
  IATA code of the arrival airport.
</ResponseField>

<ResponseField name="airlines" type="array">
  List of airlines operating the route, sorted by `score` ascending (lowest risk first).

  <Expandable title="Airline object">
    <ResponseField name="airline" type="string">
      IATA airline code.
    </ResponseField>

    <ResponseField name="airline_name" type="string">
      Full airline name.
    </ResponseField>

    <ResponseField name="score" type="integer">
      Risk Score 0–100 for this airline on this route.
    </ResponseField>

    <ResponseField name="label" type="string">
      Risk label: `Low`, `Moderate`, `High`, or `Very High`.
    </ResponseField>

    <ResponseField name="delay_rate" type="float">
      Historical delay rate (> 30 min) for this airline on this route.
    </ResponseField>

    <ResponseField name="total_flights" type="integer">
      Number of historical flights for this airline on this route.
    </ResponseField>

    <ResponseField name="confidence" type="float">
      Confidence in the score (0.0–1.0).
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.airrating.io/api/airlines?origin=FCO&dest=LHR&api_key=YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import httpx

  response = httpx.get(
      "https://app.airrating.io/api/airlines",
      params={"origin": "FCO", "dest": "LHR", "api_key": "YOUR_API_KEY"}
  )
  airlines = response.json()["airlines"]
  for a in airlines:
      print(f"{a['airline_name']}: {a['score']} ({a['label']})")
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://app.airrating.io/api/airlines?origin=FCO&dest=LHR&api_key=YOUR_API_KEY"
  );
  const { airlines } = await res.json();
  airlines.forEach(a => console.log(`${a.airline_name}: ${a.score}`));
  ```
</CodeGroup>

```json Response theme={null}
{
  "origin": "FCO",
  "dest": "LHR",
  "airlines": [
    {
      "airline": "FR",
      "airline_name": "Ryanair",
      "score": 28,
      "label": "Low",
      "delay_rate": 0.14,
      "total_flights": 543,
      "confidence": 0.91
    },
    {
      "airline": "BA",
      "airline_name": "British Airways",
      "score": 45,
      "label": "Moderate",
      "delay_rate": 0.22,
      "total_flights": 198,
      "confidence": 0.72
    },
    {
      "airline": "AZ",
      "airline_name": "ITA Airways",
      "score": 62,
      "label": "High",
      "delay_rate": 0.31,
      "total_flights": 312,
      "confidence": 0.84
    }
  ]
}
```

<Note>
  Airlines are sorted by `score` ascending — the lowest-risk carrier appears first. Use this endpoint to power a "best airline" recommendation feature.
</Note>