Расписание рейсов между станциями

# Расписание рейсов между станциями

- [Синтаксис запроса](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point#format)
- [Структура ответа](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point#emails-detailed)

Запрос позволяет получить список [рейсов](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#schedule), следующих от указанной [станции](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#station) отправления к указанной станции прибытия и информацию по каждому рейсу.


## Синтаксис запроса

```
https://api.rasp.yandex-net.ru/v3.0/search/ ?
  from=<код станции отправления>
& to=<код станции прибытия>
& [format=<формат — XML или JSON>]
& [lang=<язык>]
& [apikey=<ключ>]
& [date=<дата>]
& [transport_types=<тип транспорта>]
& [system=<система кодирования параметров to и from>]
& [show_systems=<система кодирования для ответа>]
& [offset=<сдвиг относительно первого рейса в ответе>]
& [limit=<ограничение на количество рейсов в ответе>]
& [add_days_mask=<запрос календаря хождения рейсов>]
& [result_timezone=<часовой пояс>]
& [transfers=<признак запроса маршрутов с пересадками>]
```

Пример запроса:

```
https://api.rasp.yandex-net.ru/v3.0/search/?apikey={ключ}&format=json&from=c146&to=c213&lang=ru_RU&page=1&date=2015-09-02
```

Входные параметры:

**Обязательные параметры**

|     |     |
| --- | --- |
| **Параметр** | **Описание** |
| `apikey` | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API.<br>Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:<br>```<br>Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab<br>``` |
| `from` | Код станции отправления. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).<br>При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.<br>Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:<br>- «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»);<br>- «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»). |
| `to` | Код станции прибытия. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).<br>При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.<br>Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:<br>- «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»).<br>- «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»). |

**Необязательные параметры**

|     |     |
| --- | --- |
| **Параметр** | **Описание** |
| `format` | Формат ответа. Поддерживаемые значения:<br>- `json` (по умолчанию);<br>- `xml`. |
| `lang` | Язык возвращаемой информации, в формате <код языка>\_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).<br>По умолчанию ответ возвращается для значения `ru_RU`.<br>Поддерживаемые коды языков:<br>- `ru` — русский;<br>- `uk` — украинский.<br>Поддерживаемые коды стран:<br>- `RU` — Россия;<br>- `UA` — Украина. |
| `date` | Дата, на которую необходимо получить список рейсов. Должна быть указана в формате, соответствующем стандарту [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, YYYY-MM-DD.<br>Если в запросе указана конкретная дата, в выдаче будут показаны все будущие рейсы, в том числе с пересадками.<br>Если запрос передан без даты, в выдаче будут показаны только прямые рейсы на все даты. В этом случае рейсы с пересадками не попадут в выдачу. |
| `transport_types` | Тип транспортного средства. Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — морской транспорт;<br>- `helicopter` — вертолет.<br>По умолчанию возвращается список рейсов по всем типам транспортных средств. |
| `system` | [Система кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), в которой указывается код станции отправления и код станции прибытия (параметры _from_, _to_) в запросе. Возможные значения:<br>- `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний;<br>- `iata` — [коды Международной ассоциации воздушного транспорта](https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%B4_%D0%98%D0%90%D0%A2%D0%90);<br>- `sirena` — коды в системах, построенных на базе [сетей «Сирена»](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C));<br>- `express` — коды железнодорожных станций СНГ и стран Балтии из базы [Экспресс-3](http://www.express-3.ru/);<br>- `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0).<br>Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний. |
| `show_systems` | Система кодирования, коды которой следует добавить к описанию станций в результатах поиска (элемент `codes`, вложенный в элементы `from` и `to`).<br>Поддерживаемые значения:<br>- `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний;<br>- `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0). |
| `offset` | Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10».<br>Значение по умолчанию — 0. |
| `limit` | Максимальное количество результатов поиска в ответе.<br>Значение по умолчанию — 100. |
| `add_days_mask` | Признак, который указывает, что для каждой нитки в ответе следует вернуть календарь хождения — элемент `schedule`, вложенный в элемент `segments`.<br>Поддерживаемые значения:<br>- `false` — календарь возвращать не нужно (значение по умолчанию).<br>- `true` — для каждой нитки следует вернуть календарь хождения. |
| `result_timezone` | Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции.<br>Часовые пояса следует указывать с помощью идентификаторов [базы данных tz](https://ru.wikipedia.org/wiki/Tz_database). В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «TZ» таблицы). |
| `transfers` | Признак, разрешающий добавить к результатам поиска маршруты с пересадками.<br>Поддерживаемые значения:<br>- `false` — в результатах поиска не должно быть маршрутов с пересадками (значение по умолчанию).<br>- `true` — найденные маршруты с пересадками следует добавить к результатам поиска. |

## Структура ответа

Ответ представляет собой список рейсов с информацией по каждому рейсу.

Количество рейсов, отображаемых на одной странице — не более 100\. Информация об общем количестве полученных рейсов указана в ответе в элементе `total` элемента `pagination`.

Возможные форматы ответа: JSON, XML.

Структура ответа в различных форматах показана в примерах.

Пример ответа в формате JSON

Пример ответа в формате XML

```
{
  "pagination":
  {
    "total": 11,
    "limit": 100,
    "offset": 0
  },
  "interval_segments":
  [\
    {\
      "from":\
      {\
        "code": "s9600396",\
        "title": "Симферополь",\
        "popular_title": "",\
        "short_title": "",\
        "transport_type": "plane",\
        "type": "station",\
        "station_type": "bus_stop",\
        "station_type_name": "автобусная остановка"\
      },\
      "thread":\
      {\
        "uid": "SU-1827A_c26_agent",\
        "title": "Симферополь - Москва",\
        "interval":\
        {\
          "density": "автобус раз в 10-15 минут",\
          "end_time": "2017-06-10T22:30:00",\
          "begin_time": "2017-06-10T06:00:00"\
        },\
        "number": "SU 1827",\
        "short_title": "Симферополь - Москва",\
        "thread_method_link": "api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-02&uid=U6-8_1_c30_5",\
        "carrier":\
        {\
          "code": 196,\
          "contacts": "Служба поддержки: </br> для звонков из России: 8-800 2000 000",\
          "url": "http://example.com/",\
          "logo_svg": null,\
          "title": "Example Inc.",\
          "phone": "",\
          "codes":\
          {\
            "icao": null,\
            "sirena": "У6",\
            "iata": "U6"\
          },\
          "address": "Москва, ул. Тверская, 6",\
          "logo": "//yastatic.net/rasp/media/data/company/logo/example.jpg",\
          "email": "info@example.com"\
        },\
        "transport_type": "plane",\
        "vehicle": "Airbus А321",\
        "transport_subtype":\
        {\
          "color": "#FF7F44",\
          "code": "suburban",\
          "title": "Пригородный поезд"\
        },\
        "express_type": null\
      },\
      "departure_platform": "",\
      "stops": "",\
      "departure_terminal": null,\
      "to":\
      {\
        "code": "s9600213",\
        "title": "Шереметьево",\
        "popular_title": "",\
        "short_title": "",\
        "transport_type": "plane",\
        "type": "station",\
        "station_type": "bus_stop",\
        "station_type_name": "автобусная остановка"\
      },\
      "has_transfers": false,\
      "tickets_info":\
      {\
        "et_marker": false,\
        "places":\
        [\
          {\
            "currency": "RUB",\
            "price":\
            {\
              "cents": 0,\
              "whole": 4863\
            },\
            "name": "эконом"\
          }\
        ]\
      },\
      "duration": 8100,\
      "arrival_terminal": "D",\
      "start_date": "2017-01-02",\
      "arrival_platform": ""\
    },\
    {\
      "from":\
      ...\
    }\
  ],
  "segments":
  [\
    {\
      "arrival": "2017-03-28 10:15:00",\
      "from":\
      {\
        "code": "s9600396",\
        "title": "Симферополь",\
        "popular_title": "",\
        "short_title": "",\
        "transport_type": "plane",\
        "station_type": "bus_stop",\
        "station_type_name": "автобусная остановка",\
        "type": "station"\
      },\
      "thread":\
      {\
        "uid": "SU-1827A_c26_agent",\
        "title": "Симферополь - Москва",\
        "number": "SU 1827",\
        "short_title": "Симферополь - Москва",\
        "thread_method_link": "api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-02&uid=U6-8_1_c30_5",\
        "carrier":\
        {\
          "code": 196,\
          "contacts": "Служба поддержки: </br> для звонков из России: 8-800 2000 000",\
          "url": "http://example.com/",\
          "logo_svg": null,\
          "title": "Example Inc.",\
          "phone": "",\
          "codes":\
          {\
            "icao": null,\
            "sirena": "У6",\
            "iata": "U6"\
          },\
          "address": "Москва, ул. Тверская, 6",\
          "logo": "//yastatic.net/rasp/media/data/company/logo/example.jpg",\
          "email": "info@example.com"\
        },\
        "transport_type": "plane",\
        "vehicle": "Airbus А321",\
        "transport_subtype":\
        {\
          "color": "#FF7F44",\
          "code": "suburban",\
          "title": "Пригородный поезд"\
        },\
        "express_type": null\
      },\
      "departure_platform": "",\
      "departure": "2017-03-28T06:00:00+03:00",\
      "stops": "",\
      "departure_terminal": null,\
      "to":\
      {\
        "code": "s9600213",\
        "title": "Шереметьево",\
        "popular_title": "",\
        "short_title": "",\
        "transport_type": "plane",\
        "station_type": "bus_stop",\
        "station_type_name": "автобусная остановка"\
        "type": "station"\
      },\
      "has_transfers": false,\
      "tickets_info":\
      {\
        "et_marker": false,\
        "places":\
        [\
          {\
            "currency": "RUB",\
            "price":\
            {\
              "cents": 0,\
              "whole": 4863\
            },\
            "name": "эконом"\
          }\
        ]\
      },\
      "duration": 8100,\
      "arrival_terminal": "D",\
      "start_date": "2017-01-02",\
      "arrival_platform": ""\
    },\
    {\
      "arrival":"2014-03-28T10:15:00+03:00",\
      ...\
    }\
  ],
  "search":
  {
    "date":"2017-01-02",
    "to":
    {
      "code":"c213",
      "type":"settlement",
      "popular_title":"Москва",
      "short_title":"Москва",
      "title":"Москва"
    },
    "from":
    {
      "code":"c146",
      "type":"settlement",
      "popular_title":"Симферополь",
      "short_title":"Симферополь",
      "title":"Симферополь"
    }
  }
}
```

#### Описание элементов JSON

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `pagination` | Объект | Информация о постраничном выводе найденных рейсов. |
| `interval_segments` | Массив | Список интервальных рейсов, движение по которым идет регулярно, но без определенного расписания. |
| `segments` | Массив | Список найденных рейсов. |
| `search` | Объект | Указанная в запросе дата, пункт отправления и пункт прибытия. |

**Элементы объекта**`pagination`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `total` | Число | Общее количество рейсов, удовлетворяющих условиям поиска. |
| `limit` | Число | Ограничение на количество рейсов, которые Яндекс Расписания возвращают в ответ на запрос (заданное в параметре `limit`).<br>Значение по умолчанию — 100. |
| `offset` | Число | Смещение относительно первого результата поиска, заданное в параметре `offset`.<br>Значение по умолчанию — 0. |

**Элементы объекта**`interval_segments`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `from` | Объект | Информация о станции отправления рейса. |
| `thread` | Объект | Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/thread) рейса. |
| `departure_platform` | Строка | Номер платформы станции отправления.<br>Принимает значение `null`, если номер платформы не указан. |
| `stops` | Строка (не более 1000 символов) | Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.<br>Пустая строка значит, что по пути следования остановок нет. |
| `departure_terminal` | Строка | Название терминала станции отправления.<br>Принимает значение `null`, если название терминала не указано. |
| `to` | Объект | Информация о станции прибытия рейса. |
| `has_transfers` | Булевый | Признак наличия пересадок по ходу рейса. |
| `tickets_info` | Объект | Информация о доступных типах билетов и их цене. |
| `duration` | Число | Продолжительность рейса (в секундах). |
| `arrival_terminal` | Строка | Название терминала станции прибытия.<br>Принимает значение `null`, если название терминала не указано. |
| `start_date` | Строка | Дата отправления рейса. |
| `arrival_platform` | Строка | Номер платформы станции прибытия.<br>Строка возвращается пустой, если номер платформы не указан. |

**Элементы объекта**`segments`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `arrival` | Строка | Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).<br>Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `from` | Объект | Информация о станции отправления рейса. |
| `thread` | Объект | Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/thread) рейса. |
| `departure_platform` | Строка | Номер платформы станции отправления.<br>Принимает значение `null`, если номер платформы не указан. |
| `departure` | Строка | Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).<br>Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `stops` | Строка (не более 1000 символов) | Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.<br>Пустая строка значит, что по пути следования остановок нет. |
| `departure_terminal` | Строка | Название терминала станции отправления.<br>Принимает значение `null`, если название терминала не указано. |
| `to` | Объект | Информация о станции прибытия рейса. |
| `has_transfers` | Булевый | Признак наличия пересадок по ходу рейса. |
| `tickets_info` | Объект | Информация о доступных типах билетов и их цене. |
| `duration` | Число | Продолжительность рейса (в секундах). |
| `arrival_terminal` | Строка | Название терминала станции прибытия.<br>Принимает значение `null`, если название терминала не указано. |
| `start_date` | Строка | Дата отправления рейса. |
| `arrival_platform` | Строка | Номер платформы станции прибытия.<br>Строка возвращается пустой, если номер платформы не указан. |

**Элементы объекта**`segments/from`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `title` | Строка | Название пункта отправления. |
| `station_type` | Строка | Тип пункта отправления.<br>Возможные значения:<br>- `station` — станция;<br>- `platform` — платформа;<br>- `stop` — остановочный пункт;<br>- `checkpoint` — блок-пост;<br>- `post` — пост;<br>- `crossing` — разъезд;<br>- `overtaking_point` — обгонный пункт;<br>- `train_station` — вокзал;<br>- `airport` — аэропорт;<br>- `bus_station` — автовокзал;<br>- `bus_stop` — автобусная остановка;<br>- `unknown` — станция без типа;<br>- `port` — порт;<br>- `port_point` — портпункт;<br>- `wharf` — пристань;<br>- `river_port` — речной вокзал;<br>- `marine_station` — морской вокзал. |
| `station_type_name` | Строка | Название типа пункта отправления, зависит от языка ответа. Возможные значения на русском — в списке значений ключа `station_type`. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `transport_type` | Строка | Тип отправляющегося транспортного средства.<br>Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — водный транспорт;<br>- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта отправления.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |

**Элементы объекта**`thread`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `uid` | Строка (не более 100 символов) | Идентификатор нитки, принятый в Яндекс Расписаниях. |
| `title` | Строка | Название нитки. Составляется из полных названий первой и последней станций следования. |
| `interval` | Объект | Информация о движении по интервальной нитке. |
| `number` | Строка | Номер рейса. |
| `short_title` | Строка | Короткое название нитки. Составляется из коротких названий первой и последней станций следования. |
| `thread_method_link` | Строка | URL запроса [информации о нитке](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route) с идентификатором, указанным в ключе `uid`.<br>Перед отправкой этого запроса не забудьте указать [ключ доступа к API](https://yandex.ru/dev/rasp/doc/ru/concepts/access). |
| `carrier` | Объект | Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/carrier). |
| `transport_type` | Строка | Тип транспорта. Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — водный транспорт;<br>- `helicopter` — вертолет. |
| `vehicle` | Строка | Название транспортного средства. |
| `transport_subtype` | Объект | Информация о подтипе транспортного средства. |
| `express_type` | Строка | Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`.<br>Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений:<br>- `express` — экспресс-рейс;<br>- `aeroexpress` — рейс, курсирующий между городом и аэропортом. |

**Элементы объекта**`segments/to`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код станции прибытия в системе кодирования Яндекс Расписаний. |
| `title` | Строка | Название станции прибытия. |
| `station_type` | Строка | Тип пункта назначения. Возможные значения:<br>- `station` — станция;<br>- `platform` — платформа;<br>- `stop` — остановочный пункт;<br>- `checkpoint` — блок-пост;<br>- `post` — пост;<br>- `crossing` — разъезд;<br>- `overtaking_point` — обгонный пункт;<br>- `train_station` — вокзал;<br>- `airport` — аэропорт;<br>- `bus_station` — автовокзал;<br>- `bus_stop` — автобусная остановка;<br>- `unknown` — станция без типа;<br>- `port` — порт;<br>- `port_point` — портпункт;<br>- `wharf` — пристань;<br>- `river_port` — речной вокзал;<br>- `marine_station` — морской вокзал. |
| `station_type_name` | Строка | Название типа пункта отправления, зависит от языка ответа. Возможные значения на русском — в списке значений ключа `station_type`. |
| `popular_title` | Строка | Общепринятое название станции прибытия. |
| `short_title` | Строка | Короткое название станции прибытия. |
| `transport_type` | Строка | Тип прибывающего транспортного средства. Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — водный транспорт;<br>- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта назначения.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |

**Элементы объекта**`interval`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `density` | Строка | Описание периодичности движения в свободной форме. |
| `end_time` | Строка | Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления.<br>Могут быть указаны в одном из двух форматов:<br>`YYYY-MM-DD`, если в запросе не был передан параметр `date`.<br>`YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан. |
| `begin_time` | Число | Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления.<br>Могут быть указаны в одном из двух форматов:<br>`YYYY-MM-DD`, если в запросе не был передан параметр `date`.<br>`YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан. |

**Элементы объекта**`tickets_info`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `et_marker` | Булевый | Признак возможности купить электронный билет.<br>Возможные значения:<br>- `true` — есть возможность купить электронный билет;<br>- `false` — электронный билет купить нельзя. |
| `places` | Массив | Доступные типы и цена билетов. |

**Элементы объекта**`places`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `currency` | Строка | Идентификатор валюты, в которой указана цена. |
| `price` | Объект | Цена билета. |
| `name` | Строка | Название типа билета (например, «эконом»). |

**Элементы объекта**`price`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `cents` | Число | Целое число дополнительных единиц валюты (например, копеек или центов). |
| `whole` | Число | Целое число основных единиц валюты (например, рублей). |

**Элементы объекта**`carrier`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Число | Код перевозчика в системе кодирования Яндекс Расписаний. |
| `contacts` | Строка | Контактная информация, в свободной форме. |
| `url` | Строка | Ссылка на сайт перевозчика. |
| `logo_svg` | Строка | Ссылка на используемый Яндексом логотип перевозчика в формате SVG. |
| `title` | Строка | Название перевозчика. |
| `phone` | Строка | Контактный номер телефона перевозчика. |
| `codes` | Объект | Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. |
| `address` | Строка | Юридический адрес перевозчика. |
| `logo` | Строка | Ссылка на используемый Яндексом логотип перевозчика в растровом формате. |
| `email` | Строка | Электронный почтовый адрес перевозчика. |

**Элементы объекта**`transport_subtype`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `color` | Строка | Основной цвет транспортного средства в шестнадцатеричном формате. |
| `code` | Строка | Код подтипа транспорта для типа, указанного в элементе `transport_type`. Подтип может совпадать с типом (например, для обычной электрички указывается тип `suburban` и подтип `suburban`).<br>Другие возможные значения: <br>- `helicopter` — вертолет (для типа `plane`);<br>- `rex` — экспресс РЭКС (для типа `suburban`);<br>- `sputnik` — «Спутник» (для типа `suburban`);<br>- `skiarrow` — «Лыжная стрела» (для типа `suburban`);<br>- `shezh` — «Снежинка» (для типа `suburban`);<br>- `skirus` — «Лыжня России» (для типа `suburban`);<br>- `city` — городская электричка (для типа `suburban`);<br>- `kalina` — «Калина красная» (для типа `suburban`);<br>- `vostok` — «Восток» (для типа `suburban`);<br>- `prostoryaltaya` — «Просторы Алтая» (для типа `suburban`);<br>- `14vag` — состав из 14 вагонов (для типа `suburban`);<br>- `last` — «Ласточка» (для типа `suburban`);<br>- `exprdal` — экспресс с билетами на конкретные места (для типа `suburban`);<br>- `volzhex` — «Волжский экспресс» (для типа `suburban`);<br>- `stdplus` — электрички типа «стандарт плюс» (для типа `suburban`);<br>- `express` — экспресс (для типа `suburban`);<br>- `skor` — ускоренный поезд (для типа `suburban`);<br>- `fiztekh` — Физтех.Электричка (для типа `suburban`);<br>- `vag6` — состав из 6 вагонов (для типа `suburban`);<br>- `river` — речной транспорт (для типа `water`);<br>- `sea` — морской транспорт (для типа `water`). |
| `title` | Строка | Описание подтипа транспорта на естественном языке. |

**Элементы объекта**`codes`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `icao` | Строка | Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D1%81%D0%BA%D0%BE%D0%B9_%D0%B0%D0%B2%D0%B8%D0%B0%D1%86%D0%B8%D0%B8). |
| `sirena` | Строка | Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C)). |
| `iata` | Строка | Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%B0%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D0%BE%D0%B7%D0%B4%D1%83%D1%88%D0%BD%D0%BE%D0%B3%D0%BE_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0). |

**Элементы объекта**`search`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `date` | Строка | Дата, на которую получен список рейсов, в формате «YYYY-MM-DD». |
| `to` | Объект | Информация об указанном в запросе пункте прибытия. |
| `from` | Объект | Информация об указанном в запросе пункте отправления. |

**Элементы объекта**`search/from`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта отправления.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `title` | Строка | Название пункта отправления. |

**Элементы объекта**`search/to`

|     |     |     |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код пункта прибытия в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта назначения.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |
| `popular_title` | Строка | Общепринятое название пункта прибытия. |
| `short_title` | Строка | Короткое название пункта прибытия. |
| `title` | Строка | Название пункта прибытия. |

```
<response>
  <pagination>
    <total>162</total>
    <limit>100</limit>
    <offset>0</offset>
  </pagination>
  <search>
    <date>2015-09-02</date>
    <to>
      <code>c213</code>
      <type>settlement</type>
      <popular_title>Москва</popular_title>
      <short_title>Москва</short_title>
      <title>Москва</title>
    </to>
    <from>
      <code>c146</code>
      <type>settlement</type>
      <popular_title>Симферополь</popular_title>
      <short_title>Симферополь</short_title>
      <title>Симферополь</title>
    </from>
  </search>
  <segment>
    <arrival>2017-03-28T10:15:00+03:00</arrival>
    <tickets_info>
      <et_marker>false</et_marker>
      <place>
        <currency>RUB</currency>
        <price>
          <cents>50</cents>
          <whole>61</whole>
        </price>
        <name>xsi:nil="true"</name>
      </place>
    </tickets_info>
    <duration>8100.0</duration>
    <arrival_terminal>D</arrival_terminal>
    <arrival_platform/>
    <from>
      <code>s9600396</code>
      <title>Симферополь</title>
      <short_title/>
      <popular_title/>
      <transport_type>plane</transport_type>
      <station_type_name>аэропорт</station_type_name>
      <type>station</type>
    </from>
    <thread>
      <thread_method_link>api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-14&uid=6336_0_9601458_g17_4</thread_method_link>
      <carrier>
        <code>26</code>
        <title>Example Inc.</title>
        <url>http://example.com/</url>
        <logo_svg>//yastatic.net/rasp/media/data/company/svg/example.svg</logo_svg>
        <contacts>Круглосуточная служба поддержки пассажиров: для звонков из России: 8-800 0000 000 (звонок по РФ бесплатный)</contacts>
        <phone/>
        <codes>
          <icao>xsi:nil="true"</icao>
          <sirena>СУ</sirena>
          <iata>SU</iata>
        </codes>
        <address>г. Екатеринбург, пер. Утренний, 1г</address>
        <logo>//yastatic.net/rasp/media/data/company/logo/example.png</logo>
        <email/>
      </carrier>
      <transport_type>train</transport_type>
      <uid>SU-1827A_c26_agent</uid>
      <title>Симферополь - Москва</title>
      <transport_subtype>
        <color>#FF7F44</color>
        <code>suburban</code>
        <title>Пригородный поезд</title>
      </transport_subtype>
      <vehicle>Airbus А320</vehicle>
      <number>SU 1827</number>
      <short_title>Симферополь - Москва</short_title>
      <express_type>xsi:nil="true"</express_type>
    </thread>
    <departure_platform/>
    <departure>2017-03-28T06:00:00+03:00</departure>
    <stops>кроме: Баковка, Трёхгорка, Немчиновка, Тестовская</stops>
    <start_date>2017-01-14</start_date>
    <[to](to)>
      <code>s9600213</code>
      <title>Шереметьево</title>
      <popular_title/>
      <short_title/>
      <transport_type>plane</transport_type>
      <station_type_name>аэропорт</station_type_name>
      <type>station</type>
    </to>
    <has_transfers>false</has_transfers>
    <departure_terminal>xsi:nil="true"</departure_terminal>
  </segment>
</response>
```

#### Описание элементов XML

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `pagination` |  | Информация о постраничном выводе найденных рейсов. |
| `search` |  | Указанная в запросе дата, пункт отправления и пункт прибытия. |
| `segment` |  | Информация об отдельном рейсе. |

**Элементы, вложенные в элемент**`pagination`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `total` | Число | Общее количество рейсов, удовлетворяющих условиям поиска. |
| `limit` | Число | Ограничение на количество рейсов, которые Яндекс Расписания возвращают в ответ на запрос (заданное в параметре `limit`). |
| `offset` | Число | Смещение относительно первого результата поиска, заданное в параметре `offset`. |

**Элементы, вложенные в элемент**`search`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `date` | Строка | Дата, на которую получен список рейсов, в формате «YYYY-MM-DD». |
| `to` |  | Информация об указанном в запросе пункте прибытия. |
| `from` |  | Информация об указанном в запросе пункте отправления. |

**Элементы, вложенные в элемент**`segment`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `arrival` | Строка | Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).<br>Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `tickets_info` |  | Информация о доступных типах билетов и их цене. |
| `duration` | Число | Продолжительность рейса (в секундах). |
| `arrival_terminal` | Строка | Название терминала станции прибытия.<br>Принимает значение `xsi:nil="true"`, если название терминала не указано. |
| `arrival_platform` | Число | Номер платформы станции прибытия.<br>Пустой элемент означает, что номер платформы не указан. |
| `from` |  | Информация о станции отправления рейса. |
| `thread` |  | Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin.dita#termin/thread) рейса. |
| `departure_platform` | Число | Номер платформы станции отправления.<br>Пустой элемент означает, что номер платформы не указан. |
| `departure` | Строка | Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).<br>Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `stops` | Строка (не более 1000 символов) | Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.<br>Пустой элемент означает, что станций следования, на которых совершается остановка, нет. |
| `start_date` | Строка | Дата отправления рейса. |
| `to` |  | Информация о станции прибытия рейса. |
| `has_transfers` |  | Признак наличия пересадок по ходу рейса. |
| `departure_terminal` | Строка | Название терминала станции отправления.<br>Принимает значение `xsi:nil="true"`, если название терминала не указано. |

**Элементы, вложенные в элемент**`search/to`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Строка | Код пункта прибытия в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта назначения.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |
| `popular_type` | Строка | Общепринятое название пункта прибытия. |
| `short_title` | Строка | Короткое название пункта прибытия. |
| `title` | Строка | Название пункта прибытия. |

**Элементы, вложенные в элемент**`search/from`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта отправления.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `title` | Строка | Название пункта отправления. |

**Элементы, вложенные в элемент**`tickets_info`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `et_marker` | Булевый | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `place` |  | Информация об отдельном типе билетов. |

**Элементы, вложенные в элемент**`place`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `currency` | Строка | Идентификатор валюты, в которой указана цена. |
| `price` |  | Цена билета. |
| `name` | Строка | Название типа билета (например, «эконом»). |

**Элементы, вложенные в элемент**`price`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `cents` | Число | Целое число дополнительных единиц валюты (например, копеек или центов). |
| `whole` | Число | Целое число основных единиц валюты (например, рублей). |

**Элементы, вложенные в элемент**`segment/from`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `station_type` | Строка | Тип пункта отправления.<br>Возможные значения:<br>- `station` — станция;<br>- `platform` — платформа;<br>- `stop` — остановочный пункт;<br>- `checkpoint` — блок-пост;<br>- `post` — пост;<br>- `crossing` — разъезд;<br>- `overtaking_point` — обгонный пункт;<br>- `train_station` — вокзал;<br>- `airport` — аэропорт;<br>- `bus_station` — автовокзал;<br>- `bus_stop` — автобусная остановка;<br>- `unknown` — станция без типа;<br>- `port` — порт;<br>- `port_point` — портпункт;<br>- `wharf` — пристань;<br>- `river_port` — речной вокзал;<br>- `marine_station` — морской вокзал. |
| `station_type_name` | Строка | Название типа пункта отправления, зависит от языка ответа. Возможные значения на русском — в списке значений элемента `station_type.` |
| `title` | Строка | Название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `transport_type` | Строка | Тип отправляющегося транспортного средства.<br>Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — водный транспорт;<br>- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта отправления.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |

**Элементы, вложенные в элемент**`thread`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `thread_method_link` |  | URL запроса [информации о нитке](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route) с идентификатором, указанным в ключе `uid`.<br>Перед отправкой этого запроса не забудьте указать [ключ доступа к API](https://yandex.ru/dev/rasp/doc/ru/concepts/access). |
| `carrier` |  | Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/carrier). |
| `transport_type` | Строка | Тип транспорта. Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — водный транспорт;<br>- `helicopter` — вертолет. |
| `uid` | Строка (не более 100 символов) | Идентификатор нитки, принятый в Яндекс Расписаниях. |
| `title` | Строка | Название нитки. Составляется из полных названий первой и последней станций следования. |
| `transport_subtype` |  | Информация о подтипе транспортного средства. |
| `vehicle` | Строка | Название транспортного средства. |
| `number` | Строка | Номер рейса. |
| `short_title` | Строка | Короткое название нитки. Составляется из коротких названий первой и последней станций следования. |
| `express_type` | Строка | Признак экспресса или аэроэкспресса. Значение по умолчанию — `xsi:nil="true"`.<br>Если тип транспорта — электричка (элемент `transport_type` возвращен со значением `suburban`), принимает одно из значений:<br>- `express` — экспресс-рейс;<br>- `aeroexpress` — рейс, курсирующий между городом и аэропортом. |

**Элементы, вложенные в элемент**`segment/to`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Строка | Код станции прибытия в системе кодирования Яндекс Расписаний. |
| `station_type` | Строка | Тип пункта назначения. Возможные значения:<br>- `station` — станция;<br>- `platform` — платформа;<br>- `stop` — остановочный пункт;<br>- `checkpoint` — блок-пост;<br>- `post` — пост;<br>- `crossing` — разъезд;<br>- `overtaking_point` — обгонный пункт;<br>- `train_station` — вокзал;<br>- `airport` — аэропорт;<br>- `bus_station` — автовокзал;<br>- `bus_stop` — автобусная остановка;<br>- `unknown` — станция без типа;<br>- `port` — порт;<br>- `port_point` — портпункт;<br>- `wharf` — пристань;<br>- `river_port` — речной вокзал;<br>- `marine_station` — морской вокзал. |
| `station_type_name` | Строка | Название типа пункта отправления, зависит от языка ответа. Возможные значения на русском — в списке значений элемента `station_type`. |
| `title` | Строка | Название станции прибытия. |
| `popular_title` | Строка | Общепринятое название станции прибытия. |
| `short_title` | Строка | Короткое название станции прибытия. |
| `transport_type` | Строка | Тип прибывающего транспортного средства. Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — водный транспорт;<br>- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта назначения.<br>Возможные значения:<br>- `station` — станция;<br>- `settlement` — поселение. |

**Элементы, вложенные в элемент**`carrier`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Число | Код перевозчика в системе кодирования Яндекс Расписаний. |
| `title` | Строка | Название перевозчика. |
| `url` | Строка | Ссылка на сайт перевозчика. |
| `logo_svg` | Строка | Ссылка на используемый Яндексом логотип перевозчика в формате SVG. |
| `contacts` | Строка | Контактная информация, в свободной форме. |
| `phone` | Строка | Контактный номер телефона перевозчика. |
| `codes` |  | Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. |
| `address` | Строка | Юридический адрес перевозчика. |
| `logo` | Строка | Ссылка на используемый Яндексом логотип перевозчика в растровом формате. |
| `email` | Строка | Электронный почтовый адрес перевозчика. |

**Элементы, вложенные в элемент**`transport_subtype`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `color` | Строка | Основной цвет транспортного средства в шестнадцатеричном формате. |
| `code` | Строка | Код подтипа транспорта для типа, указанного в элементе `transport_type`. Подтип может совпадать с типом (например, для обычной электрички указывается тип `suburban` и подтип `suburban`).<br>Другие возможные значения:<br>- `helicopter` — вертолет (для типа `plane`);<br>- `rex` — экспресс РЭКС (для типа `suburban`);<br>- `sputnik` — «Спутник» (для типа `suburban`);<br>- `skiarrow` — «Лыжная стрела» (для типа `suburban`);<br>- `shezh` — «Снежинка» (для типа `suburban`);<br>- `skirus` — «Лыжня России» (для типа `suburban`);<br>- `city` — городская электричка (для типа `suburban`);<br>- `kalina` — «Калина красная» (для типа `suburban`);<br>- `vostok` — «Восток» (для типа `suburban`);<br>- `prostoryaltaya` — «Просторы Алтая» (для типа `suburban`);<br>- `14vag` — состав из 14 вагонов (для типа `suburban`);<br>- `last` — «Ласточка» (для типа `suburban`);<br>- `exprdal` — экспресс с билетами на конкретные места (для типа `suburban`);<br>- `volzhex` — «Волжский экспресс» (для типа `suburban`);<br>- `stdplus` — электрички типа «стандарт плюс» (для типа `suburban`);<br>- `express` — экспресс (для типа `suburban`);<br>- `skor` — ускоренный поезд (для типа `suburban`);<br>- `fiztekh` — Физтех.Электричка (для типа `suburban`);<br>- `vag6` — состав из 6 вагонов (для типа `suburban`);<br>- `river` — речной транспорт (для типа `water`);<br>- `sea` — морской транспорт (для типа `water`). |
| `title` | Строка | Описание подтипа транспорта на естественном языке. |

**Элементы, вложенные в**`codes`

|     |     |     |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `icao` | Строка | Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D1%81%D0%BA%D0%BE%D0%B9_%D0%B0%D0%B2%D0%B8%D0%B0%D1%86%D0%B8%D0%B8). |
| `sirena` | Строка | Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C)). |
| `iata` | Строка | Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%B0%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D0%BE%D0%B7%D0%B4%D1%83%D1%88%D0%BD%D0%BE%D0%B3%D0%BE_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0). |

[Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API.

Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:

```
Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
```

Код станции отправления. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).

При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.

Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:

- «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»);
- «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»).

Код станции прибытия. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).

При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.

Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:

- «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»).
- «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»).

Формат ответа. Поддерживаемые значения:

- `json` (по умолчанию);
- `xml`.

Язык возвращаемой информации, в формате <код языка>\_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

По умолчанию ответ возвращается для значения `ru_RU`.

Поддерживаемые коды языков:

- `ru` — русский;
- `uk` — украинский.




Поддерживаемые коды стран:
- `RU` — Россия;
- `UA` — Украина.

Дата, на которую необходимо получить список рейсов. Должна быть указана в формате, соответствующем стандарту [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, YYYY-MM-DD.

Если в запросе указана конкретная дата, в выдаче будут показаны все будущие рейсы, в том числе с пересадками.

Если запрос передан без даты, в выдаче будут показаны только прямые рейсы на все даты. В этом случае рейсы с пересадками не попадут в выдачу.

Тип транспортного средства. Возможные значения:

- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — морской транспорт;
- `helicopter` — вертолет.




По умолчанию возвращается список рейсов по всем типам транспортных средств.

[Система кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), в которой указывается код станции отправления и код станции прибытия (параметры `from`, `to`) в запросе. Возможные значения:

- `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний;
- `iata` — [коды Международной ассоциации воздушного транспорта](https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%B4_%D0%98%D0%90%D0%A2%D0%90);
- `sirena` — коды в системах, построенных на базе [сетей «Сирена»](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C));
- `express` — коды железнодорожных станций СНГ и стран Балтии из базы [Экспресс-3](http://www.express-3.ru/);
- `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0).




Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний.

Система кодирования, коды которой следует добавить к описанию станций в результатах поиска (элемент codes, вложенный в элементы from и to).

Поддерживаемые значения:

yandex (значение по умолчанию) — система кодирования Яндекс Расписаний;

esr — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0).

Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10».

Значение по умолчанию — 0.

Максимальное количество результатов поиска в ответе.

Значение по умолчанию — 100.

Признак, который указывает, что для каждой нитки в ответе следует вернуть календарь хождения — элемент `schedule`, вложенный в элемент `segments`.

Поддерживаемые значения:

- `false` — календарь возвращать не нужно (значение по умолчанию).
- `true` — для каждой нитки следует вернуть календарь хождения.

Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции.

Часовые пояса следует указывать с помощью идентификаторов [базы данных tz](https://ru.wikipedia.org/wiki/Tz_database). В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «TZ» таблицы).

Признак, разрешающий добавить к результатам поиска маршруты с пересадками.

Поддерживаемые значения:

- `false` — в результатах поиска не должно быть маршрутов с пересадками (значение по умолчанию).
- `true` — найденные маршруты с пересадками следует добавить к результатам поиска.

**Тип**

Объект

**Описание**

Информация о станции отправления рейса.

**Тип**

Строка

**Описание**

Код пункта прибытия в системе кодирования Яндекс Расписаний.

**Тип**

Объект

**Описание**

Информация о постраничном выводе найденных рейсов.

**Тип**

Число

**Описание**

Общее количество рейсов, удовлетворяющих условиям поиска.

**Тип**

Число

**Описание**

Ограничение на количество рейсов, которые Яндекс Расписания возвращают в ответ на запрос (заданное в параметре `limit`).

Значение по умолчанию — 100.

**Тип**

Число

**Описание**

Смещение относительно первого результата поиска, заданное в параметре `offset`.

Значение по умолчанию — 0.

**Тип**

Объект

**Описание**

Указанная в запросе дата, пункт отправления и пункт прибытия.

**Тип**

Строка

**Описание**

Дата, на которую получен список рейсов, в формате «YYYY-MM-DD».

**Тип**

Объект

**Описание**

Информация о станции прибытия рейса.

**Тип**

Строка

**Описание**

Вид пункта отправления.

Возможные значения:

- `station` — станция;
- `settlement` — поселение.

**Тип**

Строка

**Описание**

Общепринятое название пункта отправления.

**Тип**

Строка

**Описание**

Короткое название пункта отправления.

**Тип**

Строка

**Описание**

Название пункта отправления.

Информация об отдельном рейсе.

**Тип**

Строка

**Описание**

Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).

Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.

**Тип**

Объект

**Описание**

Информация о доступных типах билетов и их цене.

**Тип**

Булевый

**Описание**

ИПризнак возможности купить электронный билет.

Возможные значения:

- true — есть возможность купить электронный билет;
- false — электронный билет купить нельзя.

Информация об отдельном типе билетов

**Тип**

Строка

**Описание**

Идентификатор валюты, в которой указана цена.

**Тип**

Объект

**Описание**

Цена билета.

**Тип**

Число

**Описание**

Целое число дополнительных единиц валюты (например, копеек или центов).

**Тип**

Число

**Описание**

Целое число основных единиц валюты (например, рублей).

**Тип**

Строка

**Описание**

Название типа билета (например, «эконом»).

**Тип**

Число

**Описание**

Продолжительность рейса (в секундах).

**Тип**

Строка

**Описание**

Название терминала станции прибытия.

Принимает значение `null`, если название терминала не указано.

**Тип**

Строка

**Описание**

Номер платформы станции прибытия.

Строка возвращается пустой, если номер платформы не указан.

**Тип**

Строка

**Описание**

Тип отправляющегося транспортного средства.

Возможные значения:

- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет.

**Тип**

Строка

**Описание**

Название типа пункта отправления, зависит от языка ответа. Возможные значения на русском — в списке значений ключа `station_type`.

**Тип**

Объект

**Описание**

Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#intervalthread) рейса.

URL запроса [информации о нитке](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route) с идентификатором, указанным в ключе `uid`.

Перед отправкой этого запроса не забудьте указать [ключ доступа к API](https://yandex.ru/dev/rasp/doc/ru/concepts/access).

**Тип**

Объект

**Описание**

Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#carrier).

**Тип**

Строка

**Описание**

Ссылка на сайт перевозчика.

**Тип**

Строка

**Описание**

Ссылка на используемый Яндексом логотип перевозчика в формате SVG.

**Тип**

Строка

**Описание**

Контактная информация, в свободной форме.

**Тип**

Строка

**Описание**

Контактный номер телефона перевозчика.

**Тип**

Объект

**Описание**

Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями.

**Тип**

Объект

**Описание**

Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D1%81%D0%BA%D0%BE%D0%B9_%D0%B0%D0%B2%D0%B8%D0%B0%D1%86%D0%B8%D0%B8).

**Тип**

Строка

**Описание**

Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C)).

**Тип**

Строка

**Описание**

Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%B0%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D0%BE%D0%B7%D0%B4%D1%83%D1%88%D0%BD%D0%BE%D0%B3%D0%BE_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0).

**Тип**

Строка

**Описание**

Юридический адрес перевозчика.

**Тип**

Строка

**Описание**

Ссылка на используемый Яндексом логотип перевозчика в растровом формате.

**Тип**

Строка

**Описание**

Электронный почтовый адрес перевозчика.

**Тип**

Строка (не более 100 символов)

**Описание**

Идентификатор нитки, принятый в Яндекс Расписаниях.

**Тип**

Объект

**Описание**

Информация о подтипе транспортного средства.

**Тип**

Строка

**Описание**

Основной цвет транспортного средства в шестнадцатеричном формате.

**Тип**

Строка

**Описание**

Название транспортного средства.

**Тип**

Строка

**Описание**

Номер рейса.

**Тип**

Строка

**Описание**

Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`.

Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений:

- `express` — экспресс-рейс;
- `aeroexpress` — рейс, курсирующий между городом и аэропортом.

**Тип**

Строка

**Описание**

Номер платформы станции отправления.

Принимает значение `null`, если номер платформы не указан.

**Тип**

Строка

**Описание**

Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).

Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.

**Тип**

Строка (не более 1000 символов)

**Описание**

Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.

Пустая строка значит, что по пути следования остановок нет.

**Тип**

Строка

**Описание**

Дата отправления рейса.

**Тип**

Булевый

**Описание**

Признак наличия пересадок по ходу рейса.

**Тип**

Строка

**Описание**

Название терминала станции отправления.

Принимает значение `null`, если название терминала не указано.
