# Routenpaare

Statistiken zu Routenpaaren nach Abflug- und/oder Zielflughafen abfragen – Fluggesellschaften, Großkreisentfernung und typische Flugdauer.



Fragen Sie Statistiken für ein bestimmtes Paar aus Abflug- und Zielort ab. Liefert Fluggesellschaften, [Großkreisentfernung](https://en.wikipedia.org/wiki/Great-circle_distance) (km) und die typische **Blockzeit** (Gate-to-Gate-Dauer der Route). Die Ergebnisse sind nach der Anzahl der Fluggesellschaften sortiert. Geben Sie mindestens einen der Parameter `departure` oder `arrival` an, um aussagekräftige Ergebnismengen zu erhalten.

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

## Anfrage [#request]

<DocApiPath method="GET" path="/routes/pairs" />

| Parameter   | Typ     | Erforderlich | Standard | Beschreibung                            |
| ----------- | ------- | ------------ | -------- | --------------------------------------- |
| `departure` | string  | Nein         | -        | IATA- oder ICAO-Code des Abflughafens   |
| `arrival`   | string  | Nein         | -        | IATA- oder ICAO-Code des Zielflughafens |
| `limit`     | integer | Nein         | `50`     | Maximale Anzahl an Ergebnissen (1–500)  |

## Antwort [#response]

```json
{
  "count": 1,
  "routes": [
    {
      "departure": "JFK",
      "arrival": "LHR",
      "airlines": ["American Airlines", "British Airways", "Delta Air Lines", "Virgin Atlantic"],
      "km": 5555,
      "duration_min": 430
    }
  ]
}
```

| Feld     | Typ     | Erforderlich | Beschreibung                                                                                              |
| -------- | ------- | ------------ | --------------------------------------------------------------------------------------------------------- |
| `count`  | integer | **Ja**       | Anzahl der zurückgegebenen Routenzeilen                                                                   |
| `routes` | array   | **Ja**       | Gleiche Struktur der Routeneinträge wie bei [Flughafenrouten](/docs/v31/routes-airport#route-item-routes) |

## Client-Typen [#client-types]

<DocClientTypes id="v31/routes/routes-types" />

## Integration [#integration]

### Hinweise zur Implementierung [#implementation-notes]

**Beide Codes bekannt.** Verwenden Sie diesen Endpoint, wenn Sie die Codes des Abflug- und des Zielflughafens bereits kennen und Kontext zu Fluggesellschaften und Flugdauer benötigen — das ist schneller, als alle Routen eines Flughafens aufzulisten.

**Paginierung.** Verwenden Sie `limit` bei breit gefassten Teiltreffern; die Standardobergrenzen halten die Antwortgrößen überschaubar.

## Fehlerantworten [#error-responses]

Validierungsfehler `422`: [Routen-Übersicht](/docs/v31/routes#error-responses).

<APIPage document="&#x22;https://api.skylinkapi.com/v3.1/openapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/routes/pairs&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />