Главная › API

API автоматической регистрации на рейсы

Передайте бронь — мы зарегистрируем пассажиров, как только откроется регистрация, и вернём посадочные: PDF авиакомпании и данные для мобильного посадочного. REST, JSON, вебхуки о каждом изменении статуса.

Песочница	`https://sandbox.checkins.ru/corp_api/v1`	получить ключ сразу →
Боевой сервер	`https://app.checkins.ru/corp_api/v1`	ключ — при подключении
Авторизация	`X-API-KEY: <ваш ключ>`	в каждом запросе

Быстрый старт

Получите ключ к песочнице — форма на одну минуту: подтвердите e-mail, и ключ придёт письмом.

Создайте заявку на регистрацию — одна бронь, её пассажиры и рейсы, пожелание по месту:

curl -X POST https://sandbox.checkins.ru/corp_api/v1/checkins \
  -H "X-API-KEY: $CHECKINS_KEY" -H "Content-Type: application/json" \
  -d @booking.json

Пример booking.json

{
  "remote_id": "suff4221231",
  "friendship_id": "group123456",
  "comment": "comment example",
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "middle_name": "William",
      "gender": "male",
      "age_class": "adult",
      "citizenship": "UK",
      "residence": "UK",
      "date_of_birth": "2026-12-01",
      "email": "psg@example.org",
      "eticket": "41241241212412",
      "seat": "1A",
      "boarding_seat": "1A",
      "boarding_info": {
        "pnr": "TC78AC",
        "date": "03 Sep",
        "seat": "1A",
        "flight": "Z0-100",
        "origin": "TXL",
        "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
        "file_id": 3494,
        "last_name": "Name",
        "passenger": "Surname/Name",
        "first_name": "Name",
        "destination": "JFK",
        "flight_code": "Z0",
        "flight_number": 100,
        "passenger_description": "",
        "check_in_sequence_number": 35
      },
      "ffn": "141414141",
      "ffn_airline": "BA",
      "passport_number": "string",
      "passport_country_of_issue": "UK",
      "passport_issue_date": "2026-12-01",
      "passport_expiry_date": "2026-12-01",
      "visa_number": "string",
      "visa_country_of_issue": "UK",
      "visa_issue_date": "2026-12-01",
      "visa_expiry_date": "2026-12-01",
      "flight_fields": [
        {
          "eticket": "Eticket1 for flight 1",
          "seat": "1A"
        },
        {
          "eticket": "Eticket2",
          "seat": "2A"
        }
      ]
    }
  ],
  "flights": [
    {
      "num": 1,
      "seatStrategies": [
        "one_psg_window",
        {
          "name": "one_psg_aisle",
          "modifiers": {
            "front": true,
            "middle": true,
            "rear": false
          }
        }
      ],
      "booking_ref": "ABCAAA",
      "departure_code": "SFO",
      "destination_code": "SFO",
      "marketing_carrier_code": "BA",
      "operating_carrier_code": "BA",
      "flight_num": "025",
      "departure_date": "2018-05-25",
      "departure_time": "15:10",
      "departure_date_utc": "2018-05-25",
      "departure_time_utc": "12:10"
    }
  ],
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ],
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  }
}

Получите результат — укажите адрес вебхука в настройках, и мы пришлём статус и посадочные, как только они будут готовы. Или запросите GET /checkin/{checkinId}.

Перед продажей услуги проверьте, регистрируем ли мы рейс: POST /checkAvailable. Справочник авиакомпаний с успешностью по каждой — здесь.

Для AI-ассистента

Спецификация открыта — её можно отдать разработчикам или своему AI, чтобы оценить интеграцию:

openapi.yaml — OpenAPI 3, все методы и схемы;
llms.txt — краткое описание сервиса и API для языковых моделей.

Изучи API автоматической регистрации на рейсы Checkins:
https://checkins.ru/api/openapi.yaml и https://checkins.ru/llms.txt.
Оцени, сколько работы займёт интеграция в наш процесс продажи авиабилетов:
какие вызовы нужны, где в нашей системе их делать, как обрабатывать вебхуки.

Регистрации

GET`/checkins`

Получить все регистрации

Параметр	Где	Тип	Описание
`created`	query	string (date-time)	Фильтр по дате создания
`status`	query	CheckinStatus
`flight_date_from`	query	string (date)	Фильтр регистраций начиная с даты вылета (включительно)
`flight_date_to`	query	string (date)	Фильтр регистраций до даты вылета (включительно)
`limit`	query	integer	Количество результатов (макс. 1000), по умолчанию 500
`offset`	query	integer	Смещение результатов. Используется для постраничного перебора (например, для получения следующей 1000 регистраций укажите `offset=1000`)

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

"string"

200 Список регистраций

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

{
  "checkins": [
    {
      "id": 1,
      "status": "idle",
      "remote_id": "suff4221231",
      "booking_ref": "ABCAAA"
    }
  ]
}

POST`/checkins`

Создать бронирование с несколькими регистрациями

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

{
  "remote_id": "suff4221231",
  "friendship_id": "group123456",
  "comment": "comment example",
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "middle_name": "William",
      "gender": "male",
      "age_class": "adult",
      "citizenship": "UK",
      "residence": "UK",
      "date_of_birth": "2026-12-01",
      "email": "psg@example.org",
      "eticket": "41241241212412",
      "seat": "1A",
      "boarding_seat": "1A",
      "boarding_info": {
        "pnr": "TC78AC",
        "date": "03 Sep",
        "seat": "1A",
        "flight": "Z0-100",
        "origin": "TXL",
        "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
        "file_id": 3494,
        "last_name": "Name",
        "passenger": "Surname/Name",
        "first_name": "Name",
        "destination": "JFK",
        "flight_code": "Z0",
        "flight_number": 100,
        "passenger_description": "",
        "check_in_sequence_number": 35
      },
      "ffn": "141414141",
      "ffn_airline": "BA",
      "passport_number": "string",
      "passport_country_of_issue": "UK",
      "passport_issue_date": "2026-12-01",
      "passport_expiry_date": "2026-12-01",
      "visa_number": "string",
      "visa_country_of_issue": "UK",
      "visa_issue_date": "2026-12-01",
      "visa_expiry_date": "2026-12-01",
      "flight_fields": [
        {
          "eticket": "Eticket1 for flight 1",
          "seat": "1A"
        },
        {
          "eticket": "Eticket2",
          "seat": "2A"
        }
      ]
    }
  ],
  "flights": [
    {
      "num": 1,
      "seatStrategies": [
        "one_psg_window",
        {
          "name": "one_psg_aisle",
          "modifiers": {
            "front": true,
            "middle": true,
            "rear": false
          }
        }
      ],
      "booking_ref": "ABCAAA",
      "departure_code": "SFO",
      "destination_code": "SFO",
      "marketing_carrier_code": "BA",
      "operating_carrier_code": "BA",
      "flight_num": "025",
      "departure_date": "2018-05-25",
      "departure_time": "15:10",
      "departure_date_utc": "2018-05-25",
      "departure_time_utc": "12:10"
    }
  ],
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ],
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  }
}

201 Создано

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

{
  "booking_id": 1,
  "checkins": [
    {
      "id": 1,
      "remote_id": "suff4221231",
      "comment": "comment example",
      "booking_id": 45,
      "reschedule_policy": {
        "reschedule_max": 120
      },
      "policies": {
        "us_drc_21d": "no"
      },
      "request": [
        "passengers.1.passport_issue_date",
        "passengers.1.residence",
        "passengers.1.passport_expiry_date",
        "passengers.2.passport_issue_date",
        "passengers.2.residence",
        "passengers.2.passport_expiry_date"
      ],
      "files": [
        {
          "url": "https://files.example.com/12/boarding.pdf",
          "expires": "2026-12-01T10:30:00Z",
          "filetype": "boardingPass"
        }
      ],
      "status": "idle",
      "fail_reason": 200,
      "scheduled_checkin_time": "2026-12-01T10:30:00Z",
      "finished_time": "2026-12-01T10:30:00Z",
      "data": {
        "remote_id": "suff4221231",
        "friendship_id": "group123456",
        "comment": "comment example",
        "passengers": [
          {}
        ],
        "flights": [
          {
            "num": 1,
            "seatStrategies": [
              "one_psg_window",
              {
                "name": "one_psg_aisle",
                "modifiers": {
                  "front": true,
                  "middle": true,
                  "rear": false
                }
              }
            ],
            "booking_ref": "ABCAAA",
            "departure_code": "SFO",
            "destination_code": "SFO",
            "marketing_carrier_code": "BA",
            "operating_carrier_code": "BA",
            "flight_num": "025",
            "departure_date": "2018-05-25",
            "departure_time": "15:10",
            "departure_date_utc": "2018-05-25",
            "departure_time_utc": "12:10"
          }
        ],
        "seatStrategies": [
          "one_psg_window",
          {
            "name": "one_psg_aisle",
            "modifiers": {
              "front": true,
              "middle": true,
              "rear": false
            }
          }
        ],
        "reschedule_policy": {
          "reschedule_max": 120
        },
        "policies": {
          "us_drc_21d": "no"
        }
      }
    }
  ]
}

405 Некорректные входные данные
422 Ошибка входных данных

GET`/checkins/{bookingId}`

Получить регистрации по bookingId

Параметр	Где	Тип	Описание
`bookingId` *	path	string	Идентификатор бронирования с несколькими рейсами

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

"string"

200 Информация о запросе

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

{
  "booking_id": 1,
  "checkins": [
    {
      "id": 1,
      "remote_id": "suff4221231",
      "comment": "comment example",
      "booking_id": 45,
      "reschedule_policy": {
        "reschedule_max": 120
      },
      "policies": {
        "us_drc_21d": "no"
      },
      "request": [
        "passengers.1.passport_issue_date",
        "passengers.1.residence",
        "passengers.1.passport_expiry_date",
        "passengers.2.passport_issue_date",
        "passengers.2.residence",
        "passengers.2.passport_expiry_date"
      ],
      "files": [
        {
          "url": "https://files.example.com/12/boarding.pdf",
          "expires": "2026-12-01T10:30:00Z",
          "filetype": "boardingPass"
        }
      ],
      "status": "idle",
      "fail_reason": 200,
      "scheduled_checkin_time": "2026-12-01T10:30:00Z",
      "finished_time": "2026-12-01T10:30:00Z",
      "data": {
        "remote_id": "suff4221231",
        "friendship_id": "group123456",
        "comment": "comment example",
        "passengers": [
          {}
        ],
        "flights": [
          {
            "num": 1,
            "seatStrategies": [
              "one_psg_window",
              {
                "name": "one_psg_aisle",
                "modifiers": {
                  "front": true,
                  "middle": true,
                  "rear": false
                }
              }
            ],
            "booking_ref": "ABCAAA",
            "departure_code": "SFO",
            "destination_code": "SFO",
            "marketing_carrier_code": "BA",
            "operating_carrier_code": "BA",
            "flight_num": "025",
            "departure_date": "2018-05-25",
            "departure_time": "15:10",
            "departure_date_utc": "2018-05-25",
            "departure_time_utc": "12:10"
          }
        ],
        "seatStrategies": [
          "one_psg_window",
          {
            "name": "one_psg_aisle",
            "modifiers": {
              "front": true,
              "middle": true,
              "rear": false
            }
          }
        ],
        "reschedule_policy": {
          "reschedule_max": 120
        },
        "policies": {
          "us_drc_21d": "no"
        }
      }
    }
  ]
}

404

POST`/checkins/abort_remote`

Остановить регистрации по remote id

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

{
  "remote_id": "suff4221231"
}

200 Результат операции
Пример ответа
```
{
  "result": "success"
}
```

GET`/checkin/{checkinId}`

Информация о регистрации

Параметр	Где	Тип	Описание
`checkinId` *	path	string	Идентификатор регистрации

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

"string"

200 Информация о регистрации

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

{
  "id": 1,
  "remote_id": "suff4221231",
  "comment": "comment example",
  "booking_id": 45,
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  },
  "request": [
    "passengers.1.passport_issue_date",
    "passengers.1.residence",
    "passengers.1.passport_expiry_date",
    "passengers.2.passport_issue_date",
    "passengers.2.residence",
    "passengers.2.passport_expiry_date"
  ],
  "files": [
    {
      "url": "https://files.example.com/12/boarding.pdf",
      "expires": "2026-12-01T10:30:00Z",
      "filetype": "boardingPass"
    }
  ],
  "status": "idle",
  "fail_reason": 200,
  "scheduled_checkin_time": "2026-12-01T10:30:00Z",
  "finished_time": "2026-12-01T10:30:00Z",
  "data": {
    "remote_id": "suff4221231",
    "friendship_id": "group123456",
    "comment": "comment example",
    "passengers": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "middle_name": "William",
        "gender": "male",
        "age_class": "adult",
        "citizenship": "UK",
        "residence": "UK",
        "date_of_birth": "2026-12-01",
        "email": "psg@example.org",
        "eticket": "41241241212412",
        "seat": "1A",
        "boarding_seat": "1A",
        "boarding_info": {
          "pnr": "TC78AC",
          "date": "03 Sep",
          "seat": "1A",
          "flight": "Z0-100",
          "origin": "TXL",
          "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
          "file_id": 3494,
          "last_name": "Name",
          "passenger": "Surname/Name",
          "first_name": "Name",
          "destination": "JFK",
          "flight_code": "Z0",
          "flight_number": 100,
          "passenger_description": "",
          "check_in_sequence_number": 35
        },
        "ffn": "141414141",
        "ffn_airline": "BA",
        "passport_number": "string",
        "passport_country_of_issue": "UK",
        "passport_issue_date": "2026-12-01",
        "passport_expiry_date": "2026-12-01",
        "visa_number": "string",
        "visa_country_of_issue": "UK",
        "visa_issue_date": "2026-12-01",
        "visa_expiry_date": "2026-12-01",
        "flight_fields": [
          {
            "eticket": "Eticket1 for flight 1",
            "seat": "1A"
          },
          {
            "eticket": "Eticket2",
            "seat": "2A"
          }
        ]
      }
    ],
    "flights": [
      {
        "num": 1,
        "seatStrategies": [
          "one_psg_window",
          {
            "name": "one_psg_aisle",
            "modifiers": {
              "front": true,
              "middle": true,
              "rear": false
            }
          }
        ],
        "booking_ref": "ABCAAA",
        "departure_code": "SFO",
        "destination_code": "SFO",
        "marketing_carrier_code": "BA",
        "operating_carrier_code": "BA",
        "flight_num": "025",
        "dep

404

PUT`/checkin/{checkinId}`

Обновить регистрацию

Параметр	Где	Тип	Описание
`checkinId` *	path	string	Идентификатор обновляемой регистрации

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

{
  "remote_id": "suff4221231",
  "friendship_id": "group123456",
  "comment": "comment example",
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "middle_name": "William",
      "gender": "male",
      "age_class": "adult",
      "citizenship": "UK",
      "residence": "UK",
      "date_of_birth": "2026-12-01",
      "email": "psg@example.org",
      "eticket": "41241241212412",
      "seat": "1A",
      "boarding_seat": "1A",
      "boarding_info": {
        "pnr": "TC78AC",
        "date": "03 Sep",
        "seat": "1A",
        "flight": "Z0-100",
        "origin": "TXL",
        "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
        "file_id": 3494,
        "last_name": "Name",
        "passenger": "Surname/Name",
        "first_name": "Name",
        "destination": "JFK",
        "flight_code": "Z0",
        "flight_number": 100,
        "passenger_description": "",
        "check_in_sequence_number": 35
      },
      "ffn": "141414141",
      "ffn_airline": "BA",
      "passport_number": "string",
      "passport_country_of_issue": "UK",
      "passport_issue_date": "2026-12-01",
      "passport_expiry_date": "2026-12-01",
      "visa_number": "string",
      "visa_country_of_issue": "UK",
      "visa_issue_date": "2026-12-01",
      "visa_expiry_date": "2026-12-01",
      "flight_fields": [
        {
          "eticket": "Eticket1 for flight 1",
          "seat": "1A"
        },
        {
          "eticket": "Eticket2",
          "seat": "2A"
        }
      ]
    }
  ],
  "flights": [
    {
      "num": 1,
      "seatStrategies": [
        "one_psg_window",
        {
          "name": "one_psg_aisle",
          "modifiers": {
            "front": true,
            "middle": true,
            "rear": false
          }
        }
      ],
      "booking_ref": "ABCAAA",
      "departure_code": "SFO",
      "destination_code": "SFO",
      "marketing_carrier_code": "BA",
      "operating_carrier_code": "BA",
      "flight_num": "025",
      "departure_date": "2018-05-25",
      "departure_time": "15:10",
      "departure_date_utc": "2018-05-25",
      "departure_time_utc": "12:10"
    }
  ],
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ],
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  }
}

200 Регистрация успешно обновлена

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

{
  "id": 1,
  "remote_id": "suff4221231",
  "comment": "comment example",
  "booking_id": 45,
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  },
  "request": [
    "passengers.1.passport_issue_date",
    "passengers.1.residence",
    "passengers.1.passport_expiry_date",
    "passengers.2.passport_issue_date",
    "passengers.2.residence",
    "passengers.2.passport_expiry_date"
  ],
  "files": [
    {
      "url": "https://files.example.com/12/boarding.pdf",
      "expires": "2026-12-01T10:30:00Z",
      "filetype": "boardingPass"
    }
  ],
  "status": "idle",
  "fail_reason": 200,
  "scheduled_checkin_time": "2026-12-01T10:30:00Z",
  "finished_time": "2026-12-01T10:30:00Z",
  "data": {
    "remote_id": "suff4221231",
    "friendship_id": "group123456",
    "comment": "comment example",
    "passengers": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "middle_name": "William",
        "gender": "male",
        "age_class": "adult",
        "citizenship": "UK",
        "residence": "UK",
        "date_of_birth": "2026-12-01",
        "email": "psg@example.org",
        "eticket": "41241241212412",
        "seat": "1A",
        "boarding_seat": "1A",
        "boarding_info": {
          "pnr": "TC78AC",
          "date": "03 Sep",
          "seat": "1A",
          "flight": "Z0-100",
          "origin": "TXL",
          "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
          "file_id": 3494,
          "last_name": "Name",
          "passenger": "Surname/Name",
          "first_name": "Name",
          "destination": "JFK",
          "flight_code": "Z0",
          "flight_number": 100,
          "passenger_description": "",
          "check_in_sequence_number": 35
        },
        "ffn": "141414141",
        "ffn_airline": "BA",
        "passport_number": "string",
        "passport_country_of_issue": "UK",
        "passport_issue_date": "2026-12-01",
        "passport_expiry_date": "2026-12-01",
        "visa_number": "string",
        "visa_country_of_issue": "UK",
        "visa_issue_date": "2026-12-01",
        "visa_expiry_date": "2026-12-01",
        "flight_fields": [
          {
            "eticket": "Eticket1 for flight 1",
            "seat": "1A"
          },
          {
            "eticket": "Eticket2",
            "seat": "2A"
          }
        ]
      }
    ],
    "flights": [
      {
        "num": 1,
        "seatStrategies": [
          "one_psg_window",
          {
            "name": "one_psg_aisle",
            "modifiers": {
              "front": true,
              "middle": true,
              "rear": false
            }
          }
        ],
        "booking_ref": "ABCAAA",
        "departure_code": "SFO",
        "destination_code": "SFO",
        "marketing_carrier_code": "BA",
        "operating_carrier_code": "BA",
        "flight_num": "025",
        "dep

404

POST`/checkin/{checkinId}/abort`

Остановить регистрацию

Параметр	Где	Тип	Описание
`checkinId` *	path	string	Идентификатор отменяемой регистрации

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

"string"

200 Результат операции
Пример ответа
```
{
  "result": "success"
}
```
404

POST`/checkin`

Добавить одну регистрацию (устарело)

Принимает только 1 рейс. Для нескольких рейсов используйте /checkins

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

{
  "remote_id": "suff4221231",
  "friendship_id": "group123456",
  "comment": "comment example",
  "passengers": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "middle_name": "William",
      "gender": "male",
      "age_class": "adult",
      "citizenship": "UK",
      "residence": "UK",
      "date_of_birth": "2026-12-01",
      "email": "psg@example.org",
      "eticket": "41241241212412",
      "seat": "1A",
      "boarding_seat": "1A",
      "boarding_info": {
        "pnr": "TC78AC",
        "date": "03 Sep",
        "seat": "1A",
        "flight": "Z0-100",
        "origin": "TXL",
        "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
        "file_id": 3494,
        "last_name": "Name",
        "passenger": "Surname/Name",
        "first_name": "Name",
        "destination": "JFK",
        "flight_code": "Z0",
        "flight_number": 100,
        "passenger_description": "",
        "check_in_sequence_number": 35
      },
      "ffn": "141414141",
      "ffn_airline": "BA",
      "passport_number": "string",
      "passport_country_of_issue": "UK",
      "passport_issue_date": "2026-12-01",
      "passport_expiry_date": "2026-12-01",
      "visa_number": "string",
      "visa_country_of_issue": "UK",
      "visa_issue_date": "2026-12-01",
      "visa_expiry_date": "2026-12-01",
      "flight_fields": [
        {
          "eticket": "Eticket1 for flight 1",
          "seat": "1A"
        },
        {
          "eticket": "Eticket2",
          "seat": "2A"
        }
      ]
    }
  ],
  "flights": [
    {
      "num": 1,
      "seatStrategies": [
        "one_psg_window",
        {
          "name": "one_psg_aisle",
          "modifiers": {
            "front": true,
            "middle": true,
            "rear": false
          }
        }
      ],
      "booking_ref": "ABCAAA",
      "departure_code": "SFO",
      "destination_code": "SFO",
      "marketing_carrier_code": "BA",
      "operating_carrier_code": "BA",
      "flight_num": "025",
      "departure_date": "2018-05-25",
      "departure_time": "15:10",
      "departure_date_utc": "2018-05-25",
      "departure_time_utc": "12:10"
    }
  ],
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ],
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  }
}

201 Создано

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

{
  "id": 1,
  "remote_id": "suff4221231",
  "comment": "comment example",
  "booking_id": 45,
  "reschedule_policy": {
    "reschedule_max": 120
  },
  "policies": {
    "us_drc_21d": "no"
  },
  "request": [
    "passengers.1.passport_issue_date",
    "passengers.1.residence",
    "passengers.1.passport_expiry_date",
    "passengers.2.passport_issue_date",
    "passengers.2.residence",
    "passengers.2.passport_expiry_date"
  ],
  "files": [
    {
      "url": "https://files.example.com/12/boarding.pdf",
      "expires": "2026-12-01T10:30:00Z",
      "filetype": "boardingPass"
    }
  ],
  "status": "idle",
  "fail_reason": 200,
  "scheduled_checkin_time": "2026-12-01T10:30:00Z",
  "finished_time": "2026-12-01T10:30:00Z",
  "data": {
    "remote_id": "suff4221231",
    "friendship_id": "group123456",
    "comment": "comment example",
    "passengers": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "middle_name": "William",
        "gender": "male",
        "age_class": "adult",
        "citizenship": "UK",
        "residence": "UK",
        "date_of_birth": "2026-12-01",
        "email": "psg@example.org",
        "eticket": "41241241212412",
        "seat": "1A",
        "boarding_seat": "1A",
        "boarding_info": {
          "pnr": "TC78AC",
          "date": "03 Sep",
          "seat": "1A",
          "flight": "Z0-100",
          "origin": "TXL",
          "barcode": "M1Surname/Name        ETC78AC ZIAJFKZ0 100  247Y1A  0043 149>6181 W 2A                                         N8",
          "file_id": 3494,
          "last_name": "Name",
          "passenger": "Surname/Name",
          "first_name": "Name",
          "destination": "JFK",
          "flight_code": "Z0",
          "flight_number": 100,
          "passenger_description": "",
          "check_in_sequence_number": 35
        },
        "ffn": "141414141",
        "ffn_airline": "BA",
        "passport_number": "string",
        "passport_country_of_issue": "UK",
        "passport_issue_date": "2026-12-01",
        "passport_expiry_date": "2026-12-01",
        "visa_number": "string",
        "visa_country_of_issue": "UK",
        "visa_issue_date": "2026-12-01",
        "visa_expiry_date": "2026-12-01",
        "flight_fields": [
          {
            "eticket": "Eticket1 for flight 1",
            "seat": "1A"
          },
          {
            "eticket": "Eticket2",
            "seat": "2A"
          }
        ]
      }
    ],
    "flights": [
      {
        "num": 1,
        "seatStrategies": [
          "one_psg_window",
          {
            "name": "one_psg_aisle",
            "modifiers": {
              "front": true,
              "middle": true,
              "rear": false
            }
          }
        ],
        "booking_ref": "ABCAAA",
        "departure_code": "SFO",
        "destination_code": "SFO",
        "marketing_carrier_code": "BA",
        "operating_carrier_code": "BA",
        "flight_num": "025",
        "dep

405 Некорректные входные данные
422 Ошибка входных данных

POST`/checkin/{checkinId}/update_boarding_passes`

Заново получить посадочные

Для зарегистрированного чекина (статус success), чей рейс ещё не вылетел: посадочные заново запрашиваются у авиакомпании. Чекин всё это время остаётся в success и хранит текущие посадочные, пока новые не получены и не проверены; затем они заменяют старые, и уведомление об успехе отправляется повторно уже с ними. Если получить корректные посадочные не удалось, у чекина остаются прежние и ничего не отправляется.

Параметр	Где	Тип	Описание
`checkinId` *	path	string	The id of the checkin

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

"string"

200 Обновление запланировано
Пример ответа
```
{
  "result": "success"
}
```
404
409 Чекин не зарегистрирован, его посадочные уже обновляются или рейс уже вылетел

Доступность рейсов

POST`/checkAvailable`

Доступность онлайн-регистрации для маршрута

"Проверить, можем ли мы выполнить онлайн-регистрацию рейсов заданной авиакомпании из заданного аэропорта"

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

{
  "airline_code": "BA",
  "operating_carrier_code": "BA",
  "departure_code": "SFO",
  "destination_code": "SFO"
}

200 Информация о доступности регистрации
Пример ответа
```
{
  "result": true,
  "is_free_try_available": true
}
```

POST`/checkMultipleAvailable`

Доступность онлайн-регистрации для нескольких маршрутов

"Проверить, можем ли мы выполнить онлайн-регистрацию рейсов авиакомпании из заданного аэропорта"

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

{
  "routes": [
    {
      "airline_code": "BA",
      "operating_carrier_code": "BA",
      "departure_code": "SFO",
      "destination_code": "SFO"
    }
  ]
}

200 Информация о доступности регистрации для нескольких маршрутов

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

{
  "result": [
    {
      "is_connected": true,
      "is_route_available": true,
      "is_free_try_available": true,
      "airline_code": "BA",
      "departure_code": "SFO",
      "destination_code": "SFO"
    }
  ]
}

POST`/checkTime`

Время и доступность онлайн-регистрации для маршрута

"Проверить, когда открывается регистрация для заданной авиакомпании в заданном аэропорту"

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

{
  "airline_code": "BA",
  "operating_carrier_code": "BA",
  "departure_code": "SFO",
  "destination_code": "SFO",
  "flight_num": "025",
  "departure_date": "2018-05-25",
  "departure_time": "15:10"
}

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

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

{
  "result": [
    {
      "airline_code": "string",
      "checkin_info": "available",
      "checkin_open_time": "2026-12-01T10:30:00Z"
    }
  ]
}

GET`/routes.json`

Возвращает все известные маршруты и их доступность

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

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

"string"

200 Доступность и возможность бесплатной попытки для каждой авиакомпании, аэропорта вылета и прилёта
Пример ответа
```
{
  "routes": [
    {
      "is_route_available": true,
      "is_free_try_available": true,
      "airline_code": "BA",
      "departure_code": "SFO",
      "destination_code": "SFO"
    }
  ]
}
```

GET`/routes.csv`

Возвращает все известные маршруты и их доступность в формате CSV

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

"string"

200 Доступность и возможность бесплатной попытки для каждой авиакомпании, аэропорта вылета и прилёта
Пример ответа
```
"string"
```

Пассажиры и места

POST`/passenger`

Создать пассажира и задать предпочтения по местам

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

{
  "passengerInfo": {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "William",
    "gender": "male",
    "age_class": "adult",
    "citizenship": "UK",
    "residence": "UK",
    "date_of_birth": "2026-12-01",
    "email": "psg@example.org",
    "remote_id": "42"
  },
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ]
}

200 Создать идентификатор пассажира и сохранить его данные в системе

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

{
  "passengerInfo": {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "William",
    "gender": "male",
    "age_class": "adult",
    "citizenship": "UK",
    "residence": "UK",
    "date_of_birth": "2026-12-01",
    "email": "psg@example.org",
    "remote_id": "42"
  },
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ]
}

GET`/passenger/{remotePassengerId}`

Получить пассажира

Параметр	Где	Тип	Описание
`remotePassengerId` *	path	string	Идентификатор получаемого пассажира

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

"string"

200 Идентификатор и данные пассажира в системе

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

{
  "passengerInfo": {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "William",
    "gender": "male",
    "age_class": "adult",
    "citizenship": "UK",
    "residence": "UK",
    "date_of_birth": "2026-12-01",
    "email": "psg@example.org",
    "remote_id": "42"
  },
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ]
}

PUT`/passenger/{remotePassengerId}`

Изменить пассажира и его предпочтения по местам

Параметр	Где	Тип	Описание
`remotePassengerId` *	path	string	Идентификатор обновляемого пассажира

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

{
  "passengerInfo": {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "William",
    "gender": "male",
    "age_class": "adult",
    "citizenship": "UK",
    "residence": "UK",
    "date_of_birth": "2026-12-01",
    "email": "psg@example.org",
    "remote_id": "42"
  },
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ]
}

200 Обновлённые данные пассажира

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

{
  "passengerInfo": {
    "first_name": "John",
    "last_name": "Doe",
    "middle_name": "William",
    "gender": "male",
    "age_class": "adult",
    "citizenship": "UK",
    "residence": "UK",
    "date_of_birth": "2026-12-01",
    "email": "psg@example.org",
    "remote_id": "42"
  },
  "seatStrategies": [
    "one_psg_window",
    {
      "name": "one_psg_aisle",
      "modifiers": {
        "front": true,
        "middle": true,
        "rear": false
      }
    }
  ]
}

DELETE`/passenger/{remotePassengerId}`

Удалить пассажира

Параметр	Где	Тип	Описание
`remotePassengerId` *	path	string	Идентификатор удаляемого пассажира

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

"string"

200 Результат операции
Пример ответа
```
{
  "result": "success"
}
```

Вебхуки

GET`/settings`

Получить настройки push_api

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

"string"

200 Объект настроек — push_api_enabled, push_api_status_url и заголовки

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

{
  "push_api_enabled": true,
  "push_api_request_enabled": true,
  "push_api_status_url": "string",
  "push_api_headers": {}
}

POST`/settings`

Настроить push_api

Принимает push_api_enabled, push_api_status_url и заголовки

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

{
  "push_api_enabled": true,
  "push_api_request_enabled": true,
  "push_api_status_url": "string",
  "push_api_headers": {}
}

201 Создано

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

{
  "push_api_enabled": true,
  "push_api_request_enabled": true,
  "push_api_status_url": "string",
  "push_api_headers": {}
}

405 Некорректные входные данные
422 Ошибка входных данных

POST`/status`

Push-уведомление об обновлении регистрации

Передаёт изменение статуса регистрации при её завершении или начале

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

{
  "status": "idle",
  "checkin": {
    "id": 1,
    "remote_id": "suff4221231",
    "comment": "comment example",
    "booking_id": 45,
    "reschedule_policy": {
      "reschedule_max": 120
    },
    "policies": {
      "us_drc_21d": "no"
    },
    "request": [
      "passengers.1.passport_issue_date",
      "passengers.1.residence",
      "passengers.1.passport_expiry_date",
      "passengers.2.passport_issue_date",
      "passengers.2.residence",
      "passengers.2.passport_expiry_date"
    ],
    "files": [
      {
        "url": "https://files.example.com/12/boarding.pdf",
        "expires": "2026-12-01T10:30:00Z",
        "filetype": "boardingPass"
      }
    ],
    "status": "idle",
    "fail_reason": 200,
    "scheduled_checkin_time": "2026-12-01T10:30:00Z",
    "finished_time": "2026-12-01T10:30:00Z",
    "data": {
      "remote_id": "suff4221231",
      "friendship_id": "group123456",
      "comment": "comment example",
      "passengers": [
        {
          "first_name": "John",
          "last_name": "Doe",
          "middle_name": "William",
          "gender": "male",
          "age_class": "adult",
          "citizenship": "UK",
          "residence": "UK",
          "date_of_birth": null,
          "email": "psg@example.org",
          "eticket": "41241241212412",
          "seat": "1A",
          "boarding_seat": "1A",
          "boarding_info": null,
          "ffn": "141414141",
          "ffn_airline": "BA",
          "passport_number": null,
          "passport_country_of_issue": "UK",
          "passport_issue_date": null,
          "passport_expiry_date": null,
          "visa_number": null,
          "visa_country_of_issue": "UK",
          "visa_issue_date": null,
          "visa_expiry_date": null,
          "flight_fields": [
            {
              "eticket": "Eticket1 for flight 1",
              "seat": "1A"
            },
            {
              "eticket": "Eticket2",
              "seat": "2A"
            }
          ]
        }
      ],
      "flights": [
        {
          "num": 1,
          "seatStrategies": [
            "one_psg_window",
            {
              "name": "one_psg_aisle",
              "modifiers": {
                "front": true,
                "middle": true,
                "rear": false
              }
            }
          ],
          "booking_ref": "ABCAAA",
          "departure_code": "SFO",
          "destination_code": "SFO",
          "marketing_carrier_code": "BA",
          "operating_carrier_code": "BA",
          "flight_num": "025",
          "departure_date": "2018-05-25",
          "departure_time": "15:10",
          "departure_date_utc": "2018-05-25",
          "departure_time_utc": "12:10"
        }
      ],
      "seatStrategies": [
        "one_psg_window",
        {
          "name": "one_psg_aisle",
          "modifiers": {
            "front": true,
            "middle": true,
            "rear": false
          }
        }
      ],
      "resch

200 Статусное сообщение обработано удалённым сервером.
Пример ответа
```
"string"
```
default Произошла ошибка. Наш сервер повторит отправку сообщения

GET`/settings/proxy-email`

Адрес прокси-почты вашего аккаунта

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

"string"

200 Префикс и домен адреса прокси-почты

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

{
  "user_id": 1,
  "prefix": "string",
  "domain": "1ch.email",
  "capability": "proxy-email-cas-v1"
}

PATCH`/settings/proxy-email`

Изменить только префикс прокси-почты

Меняет префикс, если он всё ещё равен expected_prefix; настройки вебхуков не затрагиваются. POST /settings с одним proxy_email_prefix делает то же самое без проверки expected_prefix.

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

{
  "expected_prefix": "string",
  "prefix": "string"
}

200 Изменено, или значение уже было таким

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

{
  "user_id": 1,
  "prefix": "string",
  "domain": "1ch.email",
  "capability": "proxy-email-cas-v1"
}

409 Префикс изменился после того, как вы его прочитали, либо новый префикс занят или зарезервирован
422 Недопустимый префикс

Попробуйте на песочнице

Ключ придёт сразу после подтверждения e-mail. Вопросы по интеграции — info@checkins.ru или Telegram @myagent_b2b, круглосуточно.

Получить тестовый доступ

API автоматической регистрации на рейсы

Быстрый старт

Для AI-ассистента

Регистрации

GET/checkins

POST/checkins

GET/checkins/{bookingId}

POST/checkins/abort_remote

GET/checkin/{checkinId}

PUT/checkin/{checkinId}

POST/checkin/{checkinId}/abort

POST/checkin

POST/checkin/{checkinId}/update_boarding_passes

Доступность рейсов

POST/checkAvailable

POST/checkMultipleAvailable

POST/checkTime

GET/routes.json

GET/routes.csv

Пассажиры и места

POST/passenger

GET/passenger/{remotePassengerId}

PUT/passenger/{remotePassengerId}

DELETE/passenger/{remotePassengerId}

Вебхуки

GET/settings

POST/settings

POST/status

GET/settings/proxy-email

PATCH/settings/proxy-email

Попробуйте на песочнице

GET`/checkins`

POST`/checkins`

GET`/checkins/{bookingId}`

POST`/checkins/abort_remote`

GET`/checkin/{checkinId}`

PUT`/checkin/{checkinId}`

POST`/checkin/{checkinId}/abort`

POST`/checkin`

POST`/checkin/{checkinId}/update_boarding_passes`

POST`/checkAvailable`

POST`/checkMultipleAvailable`

POST`/checkTime`

GET`/routes.json`

GET`/routes.csv`

POST`/passenger`

GET`/passenger/{remotePassengerId}`

PUT`/passenger/{remotePassengerId}`

DELETE`/passenger/{remotePassengerId}`

GET`/settings`

POST`/settings`

POST`/status`

GET`/settings/proxy-email`

PATCH`/settings/proxy-email`