# Пары маршрутов

Статистика пар маршрутов по аэропорту вылета и/или прилёта: авиакомпании, расстояние по ортодромии и типичная продолжительность.



Запрос статистики по конкретной паре «пункт отправления — пункт назначения». Возвращает перевозчиков, [расстояние по ортодромии](https://en.wikipedia.org/wiki/Great-circle_distance) (km) и типичное **блочное время** (время от гейта до гейта на маршруте). Результаты отсортированы по количеству авиакомпаний. Чтобы получить полезную выборку, укажите хотя бы один из параметров `departure` или `arrival`.

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

## Запрос [#request]

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

| Параметр    | Тип     | Обязательный | По умолчанию | Описание                               |
| ----------- | ------- | ------------ | ------------ | -------------------------------------- |
| `departure` | string  | Нет          | -            | Аэропорт вылета, код IATA или ICAO     |
| `arrival`   | string  | Нет          | -            | Аэропорт прилёта, код IATA или ICAO    |
| `limit`     | integer | Нет          | `50`         | Максимальное число результатов (1–500) |

## Ответ [#response]

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

| Поле     | Тип     | Обязательный | Описание                                                                                                    |
| -------- | ------- | ------------ | ----------------------------------------------------------------------------------------------------------- |
| `count`  | integer | **Да**       | Число возвращённых строк маршрутов                                                                          |
| `routes` | array   | **Да**       | Та же структура элемента маршрута, что и в [Маршруты аэропорта](/docs/v31/routes-airport#route-item-routes) |

## Клиентские типы [#client-types]

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

## Интеграция [#integration]

### Примечания по реализации [#implementation-notes]

**Известны оба кода.** Используйте этот эндпоинт, когда коды аэропортов вылета и прилёта уже известны и нужен контекст о перевозчиках и продолжительности, — это быстрее, чем перебирать все маршруты одного аэропорта.

**Пагинация.** Используйте `limit` при широких запросах с частичным совпадением; ограничения по умолчанию сохраняют размер ответа управляемым.

## Ответы с ошибками [#error-responses]

Ошибки валидации `422`: [раздел «Маршруты»](/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;}]" />