OSAGO Integration API (1.6.0 - 23.03.2026)

Download OpenAPI specification:

API для интеграции с блоком ОСАГО

Документация является технической версией API

Дата	Изменение
08.08.2025	Добавлен метод получения сведений об авто по ГРЗ или VIN
12.08.2025	Убрана пагинация
12.08.2025	Удалены лишние параметры
12.08.2025	Изменена модель обязательности параметров
12.08.2025	Добавлен метод `POST /osago/offer` в качестве подтверждения оформления полиса
12.08.2025	Добавлены: ФИАС-код адреса, ФИАС региона, ФИАС района, ФИАС города, ФИАС населенного пункта, ФИАС улицы, ФИАС до дома
12.08.2025	Добавлено поле `is_reinsurance_pool` - принадлежность к перестраховочному пулу
12.08.2025	Изменен объект `UpsaleInfo` и вложенные объекты
12.08.2025	Изменен формат ответа на `/offer/draft`
12.08.2025	Добавлен метод на стороне Яндекса GET/POST `/confirm` для отправки подтверждения продажи полиса
13.08.2025	Подтвердение становится подтверждением
13.08.2025	Добавлена схема обработки оффлайн-конверсий
01.09.2025	В метод `/dictionaries/years` добавлено поле `Категории транспортных средств`
03.09.2025	Я календарь перевернул
03.09.2025	Добавлен метод `/osago/offer/policy` для получения полиса после оплаты
13.10.2025	Обновлена диаграмма последовательности для флоу покупки полиса
15.10.2025	Исправлен метод `POST /confirm`, добавлена возможность возвращать массив request_id
15.10.2025	Исправлено поле logo_url для объекта PartnerInfo
27.10.2025	Добавлено поле `region_type`
10.11.2025	Изменена политика обязательности: - Для страхователя и собственника убраны обязательные поля "Водительское удостоверение" - Для водителей убраны обязательные поля "Паспорт" и "Адрес" - Контакты обязательны только для страхователя - Убрана обязательность поля `return_urls` из расчета стоимости
12.11.2025	Добавлено поле `city_type` - тип города
19.11.2025	Исправлена ошибка в методе `GET /confirm` - изменен тип поля `is_upsaled` на `boolean`
21.01.2026	Добавлено необязательное поле `policy_start_date` в модель предложения. Если страховая компания согласна выдать полис не в дату, запрошенную пользователем, а в другую ближайшую, ее следует передать в этом поле
21.01.2026	Добавлено поле `conversion_date` в модель оффлайн-конверсии. В поле следует передавать время и дату покупки полиса пользователем в таймзоне UTC +0
30.01.2026	request_id удален из ответов с кодом 403
30.01.2026	в методе GET /confirm, для кода 400, ответ обернут в массив
30.01.2026	в методе GET /confirm, поле offer_id теперь не обязательно
02.03.2026	в объект `AddressInfo` добавлено поле `postal_code` - почтовый индекс
18.03.2026	в объект `PreviousLicenseInfo` убрана обязательность поля `date` - в предыдущем водительском удостоверении дата не обязательна
23.03.2026	Обновлена модель `UpsaleInfo`: удалено поле `upsale_code`, поля `full_name`, `insured`, `insurance_period` стали необязательными, поле `options` стало обязательным
23.03.2026	Обновлена модель `UpsaleOption`: тип поля `id` изменен с `integer` на `string`, добавлено обязательное поле `kid_link`, тип поля `compatibility_id` изменен с `integer` на `string`, удалено поле `risk_payments`, добавлены обязательные поля: `id`, `name`, `description`, `kid_link`, `price`
23.03.2026	Обновлена модель `ConfirmOsagoOfferRequest`: в объекте upsales поле `option_id` заменено на `options` (массив строк), поле `options` стало обязательным
23.03.2026	Удалена модель `RiskPayment`

Позволяет продавать полисы ОСАГО через тематический блок на серпе и финансовых вертикалях поиска

Дизайн тематического блока

На страницу с результатами поиска добавятся следующие блоки (дизайн может быть изменен):

Диаграма последовательности

Справочники

Методы, предоставляющие справочники транспортных средств

Вызываются автоматически по планировщику для обновления справочников Все ID справочников должны быть уникальными и не должны меняться в ходе обновления справочников на стороне партнера

Важно

В случае изменения справочников на стороне партнера, необходимо предупредить команду Яндекса для оперативного обновления справочников

Если партнер - агрегатор, надеемся что у вас единый справочник транспортных средств

Получение списка брендов

Метод для получения списка брендов

query Parameters

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"brands": [{"brand_id": "string",
"name": "string",
"name_ru": "string"
}
]
}

Получение списка моделей

Метод для получения списка моделей

query Parameters

category required	Array of strings Items Enum: "A" "B" "C" "D" "E" Категории транспортных средств
brand_id required	string Идентификатор бренда

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"brand_id": "string",
"models": [{"model_id": "string",
"name": "string",
"name_ru": "string",
"vehicle_type": ["A"
]
}
]
}

Получение списка годов выпуска

Метод для получения списка годов выпуска

query Parameters

model_id required	any <string> Идентификатор модели
category required	Array of strings Items Enum: "A" "B" "C" "D" "E" Категории транспортных средств

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"brand_id": "string",
"model_id": "string",
"years": [2021
]
}

Получение списка мощностей двигателя

Метод для получения списка мощностей двигателя

query Parameters

model_id required	string Example: model_id=123 Идентификатор модели
year required	number <integer> Example: year=2020 Год выпуска

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"model_id": "string",
"year": 0,
"powers": [0.1
]
}

Получение списка модификаций (не обязательный)

Метод для получения списка модификаций Получение списка модификаций не является обязательным.

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

query Parameters

model_id required	string Example: model_id=123 Идентификатор модели
year required	number <integer> Example: year=2020 Год выпуска
power required	number <integer> Example: power=123 Мощность двигателя

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"modifications": [{"id": 1,
"name": "2.4 Luxe, Седан, Автоматическая, Бензин, дверей 4, мест 5"
}
]
}

Получение иерархии автомобильных данных (не обязательный)

Возвращает полную структуру:

Бренды
Модели
Годы выпуска
Мощности двигателей

query Parameters

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"brands": [{"brand_id": 1,
"name": "Toyota",
"name_ru": "Тойота",
"models": [{"model_id": "101",
"name": "Camry",
"name_ru": "Камри",
"vehicle_types": ["B"
],
"years": [{"year": 2023,
"engine_powers": [150,
200
]
}
]
}
]
}
]
}

Получение информации об автомобиле

Метод для получения информации об автомобиле по VIN-коду или гос. номеру

query Parameters

vin	string Example: vin=WVWZZZ1JZDW123456 VIN-код автомобиля
car_number	string Example: car_number=A123AA123 Гос. номер автомобиля

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"car_number": "А123БВ777",
"category": "B",
"vin": "XTA210990Y2765439",
"body_number": "ABC123456789",
"chassis_number": "CHS987654321",
"brand": {"brand_id": "1",
"name": "Toyota",
"name_ru": "Тойота"
},
"model": {"model_id": "101",
"name": "Camry",
"name_ru": "Камри"
},
"modification": {"modification_id": "5001",
"name": "2.0 Turbo (249 л.с.)"
},
"year": 2020,
"engine_power": 150,
"car_documents": [{"series": "77AA",
"number": "123456",
"date": "2020-05-15",
"document_type": "sts"
}
]
}

ОСАГО

Методы для интеграции с блоком ОСАГО

Создание запроса на расчет ОСАГО

Метод для инициализации запроса на расчет ОСАГО

Request Body schema: application/json
required

product_type required	string Value: "osago" Тип продукта
partner required	string Value: "yandex" Название партнера
request_id required	string <uuid> Идентификатор запроса
is_cross_allowed required	boolean Разрешены ли кросс-продажи и вмененки
purpose required	string Default: "personal" Enum: "taxi" "personal" Назначение полиса `taxi` - полис для такси `personal` - полис для личного использования
policy_start_date required	string <date-time> Дата начала действия полиса
required	object (VehicleInfo) Информация о транспортном средстве
required	object (DriversInfo) Информация о водителях
required	object (PersonInfo) Информация о владельце
required	object (PersonInfo) Информация о страхователе
	object (ReturnUrls) Ссылки для возврата после оплаты

Responses

Request samples

Payload

Content type

application/json

{"product_type": "osago",
"partner": "yandex",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"is_cross_allowed": true,
"purpose": "taxi",
"policy_start_date": "2023-12-01T00:00:00Z",
"vehicle": {"car_number": "А123БВ777",
"category": "B",
"vin": "XTA210990Y2765439",
"body_number": "ABC123456789",
"chassis_number": "CHS987654321",
"brand": {"brand_id": "1",
"name": "Toyota",
"name_ru": "Тойота"
},
"model": {"model_id": "101",
"name": "Camry",
"name_ru": "Камри"
},
"modification": {"modification_id": "5001",
"name": "2.0 Turbo (249 л.с.)"
},
"year": 2020,
"engine_power": 150,
"car_documents": [{"series": "77AA",
"number": "123456",
"date": "2020-05-15",
"document_type": "sts"
}
]
},
"drivers_info": {"is_unlimited_drivers": false,
"drivers": [{"last_name": "Иванов",
"middle_name": "Иванович",
"first_name": "Иван",
"birth_date": "1980-06-12",
"license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
},
"foreign_license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
},
"previous_license": {"last_name": "Иванов",
"middle_name": "Иванович",
"first_name": "Иван",
"license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
}
},
"passport": {"series": "1234",
"number": "567890",
"issue_date": "2010-10-05",
"issuer": "ОУФМС России по г. Москве",
"subdivision": "770-001"
},
"addresses": [{"type": "registration",
"address": "Красноярский край, г. Красноярск, ул. Ленина, д. 1, кв. 1",
"country_code": "7",
"region_name": "Красноярский край",
"region_type": "г",
"district_name": "Сибирский",
"city_name": "Красноярск",
"city_type": "г",
"settlement_name": "Красноярск",
"settlement_type": "г",
"street_name": "Ленина",
"street_type": "ул",
"house": "1",
"building": "",
"block": "",
"apartment": "1",
"postal_code": "770066",
"addresses_kladr_code": "7700000000000000001",
"region_kladr_code": "7700000000000",
"city_kladr_code": "7700000000000",
"settlement_kladr_code": "",
"street_kladr_code": "7700000000000010000",
"fias_code": "f26b876b-6857-4951-b060-ec6559f04a9a",
"region_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"area_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"settlement_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"street_fias_code": "95dbf7fb-0dd4-4a04-8100-4f6c847564b5",
"house_fias_code": "00a77cd5-e431-46df-8832-f9f462c15205"
}
],
"contact": {"phone": "79161234567",
"email": "user@example.com"
}
}
]
},
"owner": {"last_name": "Иванов",
"middle_name": "Иванович",
"first_name": "Иван",
"birth_date": "1980-06-12",
"license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
},
"foreign_license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
},
"previous_license": {"last_name": "Иванов",
"middle_name": "Иванович",
"first_name": "Иван",
"license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
}
},
"passport": {"series": "1234",
"number": "567890",
"issue_date": "2010-10-05",
"issuer": "ОУФМС России по г. Москве",
"subdivision": "770-001"
},
"addresses": [{"type": "registration",
"address": "Красноярский край, г. Красноярск, ул. Ленина, д. 1, кв. 1",
"country_code": "7",
"region_name": "Красноярский край",
"region_type": "г",
"district_name": "Сибирский",
"city_name": "Красноярск",
"city_type": "г",
"settlement_name": "Красноярск",
"settlement_type": "г",
"street_name": "Ленина",
"street_type": "ул",
"house": "1",
"building": "",
"block": "",
"apartment": "1",
"postal_code": "770066",
"addresses_kladr_code": "7700000000000000001",
"region_kladr_code": "7700000000000",
"city_kladr_code": "7700000000000",
"settlement_kladr_code": "",
"street_kladr_code": "7700000000000010000",
"fias_code": "f26b876b-6857-4951-b060-ec6559f04a9a",
"region_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"area_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"settlement_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"street_fias_code": "95dbf7fb-0dd4-4a04-8100-4f6c847564b5",
"house_fias_code": "00a77cd5-e431-46df-8832-f9f462c15205"
}
],
"contact": {"phone": "79161234567",
"email": "user@example.com"
}
},
"insurer": {"last_name": "Иванов",
"middle_name": "Иванович",
"first_name": "Иван",
"birth_date": "1980-06-12",
"license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
},
"foreign_license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
},
"previous_license": {"last_name": "Иванов",
"middle_name": "Иванович",
"first_name": "Иван",
"license": {"series": "77AA",
"number": "123456",
"date": "2015-06-10"
}
},
"passport": {"series": "1234",
"number": "567890",
"issue_date": "2010-10-05",
"issuer": "ОУФМС России по г. Москве",
"subdivision": "770-001"
},
"addresses": [{"type": "registration",
"address": "Красноярский край, г. Красноярск, ул. Ленина, д. 1, кв. 1",
"country_code": "7",
"region_name": "Красноярский край",
"region_type": "г",
"district_name": "Сибирский",
"city_name": "Красноярск",
"city_type": "г",
"settlement_name": "Красноярск",
"settlement_type": "г",
"street_name": "Ленина",
"street_type": "ул",
"house": "1",
"building": "",
"block": "",
"apartment": "1",
"postal_code": "770066",
"addresses_kladr_code": "7700000000000000001",
"region_kladr_code": "7700000000000",
"city_kladr_code": "7700000000000",
"settlement_kladr_code": "",
"street_kladr_code": "7700000000000010000",
"fias_code": "f26b876b-6857-4951-b060-ec6559f04a9a",
"region_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"area_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"settlement_fias_code": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"street_fias_code": "95dbf7fb-0dd4-4a04-8100-4f6c847564b5",
"house_fias_code": "00a77cd5-e431-46df-8832-f9f462c15205"
}
],
"contact": {"phone": "79161234567",
"email": "user@example.com"
}
},
"return_urls": {"success_url": "https://example.com/osago/success",
"failure_url": "https://example.com/osago/failure"
}
}

Response samples

200
400
403
404
500

Content type

application/json

{"request_id": "550e8400-e29b-41d4-a716-446655440000",
"calculation_date": "2023-12-01T00:00:00Z"
}

Получение расчета ОСАГО

Метод для получения расчета ОСАГО по идентификатору запроса

В рамках предложений можно сразу рассчитать полис, если это возможн, и отправить ссылку на черновик / оплату. Альтернативой служит дальнейший вызов метода получения предложения для финального расчета

Со стороны Яндекса осущетвляется polling метода (не чаще чам 1 раз в секунду, не дольше 3х минут) пока статус расчета не будет равен:

CALCULATION_READY - Расчет готов
NO_CALCULATION_AVAILABLE - Отсутствуют доступные рассчеты
CALCULATION_ERROR - Ошибка расчета

query Parameters

request_id

required

string <uuid>

Example: request_id=123e4567-e89b-12d3-a456-426614174000

Идентификатор запроса

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"request_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "DRAFT",
"partner": {"code": 12,
"name": "Банки.ру",
"logo_url": "//partner.ru/ugc/logo_135x85.gif"
},
"offers": [{"offer_id": "44234899",
"policy_start_date": "2023-12-01T00:00:00Z",
"partner": {"code": 12,
"name": "Банки.ру",
"logo_url": "//partner.ru/ugc/logo_135x85.gif"
},
"price": 7072,
"status": "CREATED",
"is_prolongation": true,
"is_ext_prolongation": false,
"is_reinsurance_pool": false,
"draft_url": "https://partner.ru/policy?id=112233",
"payment_url": "https://pay.it/policy?id=112233",
"policy_series": "ХХХ",
"policy_number": "0166171796",
"message": "Требуется указать действительный адрес проживания",
"upsales": [{"id": "11223-cross-sale",
"is_required": true,
"short_name": "Добавить к полису ОСАГО защиту от несчастного случая при ДТП",
"full_name": "Страхование пассажиров от несчастного случая при ДТП",
"insured": "Все, кто находился в машине в момент ДТП, до 5 человек",
"insurance_period": "1 год",
"options": [{"id": "11223-cross-sale-option-1",
"is_default": true,
"compatibility_id": "1",
"name": "Страхование пассажиров",
"description": "При страховом случае (ДТП) страховая компания осуществит выплату, которую можно потратить на лечение.Общее страховое покрытие: 100 000 ₽",
"kid_link": "https://www.partner.ru/docs/kid-1.pdf",
"insured": "Все, кто находился в машине в момент ДТП, до 5 человек",
"price": 1480
}
]
}
]
}
],
"drivers": [{"series": "1234",
"number": "123456",
"coefficients": {"tb": 6896,
"kt": 1.8,
"kbm": 1.17,
"kvs": 1,
"ks": 1,
"kp": 1,
"km": 1.1,
"kn": 1,
"ko": 2.32,
"kpr": 1
}
}
]
}

Получение статуса расчета ОСАГО (не обязательный)

Метод для получения статуса расчета ОСАГО по идентификатору запроса (не обязательный)

query Parameters

request_id

required

string <uuid>

Example: request_id=123e4567-e89b-12d3-a456-426614174000

Идентификатор запроса

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"request_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "DRAFT",
"offers": [{"offer_id": "string",
"offer_status": "CREATED"
}
]
}

Получение предложения ОСАГО (не обязательный)

Метод для получения предложения ОСАГО по идентификатору запроса

query Parameters

request_id required	string <uuid> Example: request_id=123e4567-e89b-12d3-a456-426614174000 Идентификатор запроса
offer_id required	string Example: offer_id=offer_123456789 Идентификатор предложения

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"offer_id": "44234899",
"policy_start_date": "2023-12-01T00:00:00Z",
"partner": {"code": 12,
"name": "Банки.ру",
"logo_url": "//partner.ru/ugc/logo_135x85.gif"
},
"price": 7072,
"status": "CREATED",
"is_prolongation": true,
"is_ext_prolongation": false,
"is_reinsurance_pool": false,
"draft_url": "https://partner.ru/policy?id=112233",
"payment_url": "https://pay.it/policy?id=112233",
"policy_series": "ХХХ",
"policy_number": "0166171796",
"message": "Требуется указать действительный адрес проживания",
"upsales": [{"id": "11223-cross-sale",
"is_required": true,
"short_name": "Добавить к полису ОСАГО защиту от несчастного случая при ДТП",
"full_name": "Страхование пассажиров от несчастного случая при ДТП",
"insured": "Все, кто находился в машине в момент ДТП, до 5 человек",
"insurance_period": "1 год",
"options": [{"id": "11223-cross-sale-option-1",
"is_default": true,
"compatibility_id": "1",
"name": "Страхование пассажиров",
"description": "При страховом случае (ДТП) страховая компания осуществит выплату, которую можно потратить на лечение.Общее страховое покрытие: 100 000 ₽",
"kid_link": "https://www.partner.ru/docs/kid-1.pdf",
"insured": "Все, кто находился в машине в момент ДТП, до 5 человек",
"price": 1480
}
]
}
]
}

Подтверждние предложения ОСАГО (confirm)

Метод для подтверждения предложения ОСАГО по идентификатору запроса (используется не всеми партнерами)

Request Body schema: application/json

request_id required	string <uuid> Идентификатор запроса
offer_id required	string Идентификатор предложения
	object (ReturnUrls) Ссылки для возврата после оплаты
	Array of objects Массив кросс-продаж, выбранных к предложению

Responses

Request samples

Payload

Content type

application/json

{"request_id": "550e8400-e29b-41d4-a716-446655440000",
"offer_id": "string",
"return_urls": {"success_url": "https://example.com/osago/success",
"failure_url": "https://example.com/osago/failure"
},
"upsales": [{"upsale_id": "string",
"options": ["string"
]
}
]
}

Response samples

200
400
403
404
500

Content type

application/json

{"offer_id": "44234899",
"policy_start_date": "2023-12-01T00:00:00Z",
"partner": {"code": 12,
"name": "Банки.ру",
"logo_url": "//partner.ru/ugc/logo_135x85.gif"
},
"price": 7072,
"status": "CREATED",
"is_prolongation": true,
"is_ext_prolongation": false,
"is_reinsurance_pool": false,
"draft_url": "https://partner.ru/policy?id=112233",
"payment_url": "https://pay.it/policy?id=112233",
"policy_series": "ХХХ",
"policy_number": "0166171796",
"message": "Требуется указать действительный адрес проживания",
"upsales": [{"id": "11223-cross-sale",
"is_required": true,
"short_name": "Добавить к полису ОСАГО защиту от несчастного случая при ДТП",
"full_name": "Страхование пассажиров от несчастного случая при ДТП",
"insured": "Все, кто находился в машине в момент ДТП, до 5 человек",
"insurance_period": "1 год",
"options": [{"id": "11223-cross-sale-option-1",
"is_default": true,
"compatibility_id": "1",
"name": "Страхование пассажиров",
"description": "При страховом случае (ДТП) страховая компания осуществит выплату, которую можно потратить на лечение.Общее страховое покрытие: 100 000 ₽",
"kid_link": "https://www.partner.ru/docs/kid-1.pdf",
"insured": "Все, кто находился в машине в момент ДТП, до 5 человек",
"price": 1480
}
]
}
]
}

Запрос на получение pdf-файла с черновиком полиса

Метод для получения pdf-файла с черновиком полиса по идентификатору запроса

Можно перезапрашивать каждые 5 секунд не более 5 минут до получения статуса success и ссылки на черновик

query Parameters

request_id required	string <uuid> Example: request_id=123e4567-e89b-12d3-a456-426614174000 Идентификатор запроса
offer_id required	string Example: offer_id=offer_123456789 Идентификатор предложения

Responses

Response samples

200
400
403
404
500

Content type

application/json

Example

Успешный

{"request_id": "550e8400-e29b-41d4-a716-446655440000",
"offer_id": "string",
"status": "success",
"url": "string",
"file": {"type": "base64",
"data": "data:application/pdf;base64,JVBERi0xLjUK..."
}
}

Запрос на получение полиса

Метод для получения pdf-файла с полисом по идентификатору запроса

Можно перезапрашивать каждые 5 секунд не более 5 минут до получения статуса success и ссылки на полис

query Parameters

request_id required	string <uuid> Example: request_id=123e4567-e89b-12d3-a456-426614174000 Идентификатор запроса
offer_id required	string Example: offer_id=offer_123456789 Идентификатор предложения

Responses

Response samples

200
400
403
404
500

Content type

application/json

{"request_id": "550e8400-e29b-41d4-a716-446655440000",
"offer_id": "string",
"status": "CREATED",
"policy_start_date": "2023-12-01T00:00:00Z",
"url": "string",
"file": {"type": "base64",
"data": "data:application/pdf;base64,JVBERi0xLjUK..."
}
}

Служебные методы

Проверка работоспособности сервера

Возвращает текущее состояние интеграции:

Общая доступность API
Доступность расчетов ОСАГО
Плановые работы
Доступность НСИС (Национальной системы страховых исчислений)
Статусы подключенных партнеров

Responses

Response samples

200
400
503

Content type

application/json

{"api_status": "OPERATIONAL",
"calculation_available": true,
"planned_maintenance": {"in_progress": false,
"next_maintenance": "2023-12-25T03:00:00Z",
"duration_minutes": 120,
"description": "Обновление справочников ТС"
},
"nsis_status": {"status": "OPERATIONAL",
"last_sync": "2023-12-20T13:45:00Z",
"error_message": "Timeout подключения к НСИС"
},
"timestamp": "2023-12-20T14:30:00Z"
}

Подтверждение продажи

Подтверждение обработки заявки POST

Метод подтверждения факта оформления договора

Может быть как GET, так и POST Для POST доступна массовая отправка данных

Диаграма последовательности

Request Body schema: application/json
required

partner_id required	integer Идентификатор партнера, с которым настроена интеграция
required	Array of objects (ConfirmItem) Объект подтверждения продажи

Responses

Request samples

Payload

Content type

application/json

{"partner_id": 0,
"data": [{"request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
"counterparty_id": 0,
"offer_id": "string",
"amount": 0,
"conversion_date": "2019-08-24T14:15:22Z",
"is_upsaled": true
}
]
}

Response samples

200
400
403
500

Content type

application/json

[{"request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}
]

Подтверждение обработки заявки GET

Метод подтверждения факта оформления полиса

Может быть как GET, так и POST Для POST доступна массовая отправка данных

query Parameters

request_id required	integer Идентификатор запроса
partner_id required	string Идентификатор партнера, с которым настроена интеграция
counterparty_id required	integer Идентификатор партнера, который выдал полис
offer_id	string Идентификатор предложения
amount required	number Сумма общей страховой премии
conversion_date	string <date-time> Дата и время продажи полиса
is_upsaled	boolean Признак наличия кросс-продаж

Responses

Response samples

200
400
403
500

Content type

application/json

{"request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}

OSAGO Integration API (1.6.0 - 23.03.2026)

API для интеграции с блоком ОСАГО

Дизайн тематического блока

Диаграма последовательности

Справочники

Методы, предоставляющие справочники транспортных средств

Важно

Получение списка брендов

query Parameters

Responses

Response samples

Получение списка моделей

query Parameters

Responses

Response samples

Получение списка годов выпуска

query Parameters

Responses

Response samples

Получение списка мощностей двигателя

query Parameters

Responses

Response samples

Получение списка модификаций (не обязательный)

query Parameters

Responses

Response samples

Получение иерархии автомобильных данных (не обязательный)

query Parameters

Responses

Response samples

Получение информации об автомобиле

query Parameters

Responses

Response samples

ОСАГО

Методы для интеграции с блоком ОСАГО

Создание запроса на расчет ОСАГО

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Получение расчета ОСАГО

query Parameters

Responses

Response samples

Получение статуса расчета ОСАГО (не обязательный)

query Parameters

Responses

Response samples

Получение предложения ОСАГО (не обязательный)

query Parameters

Responses

Response samples

Подтверждние предложения ОСАГО (confirm)

Request Body schema: application/json

Responses

Request samples

Response samples

Запрос на получение pdf-файла с черновиком полиса

query Parameters

Responses

Response samples

Запрос на получение полиса

query Parameters

Responses

Response samples

Служебные методы

Проверка работоспособности сервера

Responses

Response samples

Подтверждение продажи

Подтверждение обработки заявки POST

Диаграма последовательности

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Подтверждение обработки заявки GET

query Parameters

Request Body schema: application/json
required

Request Body schema: application/json
required