Кадастр

POST/v1/suggest/cadastre
POST/v1/find/cadastre

Поиск объектов недвижимости по кадастровому номеру. suggest понимает полный номер, квартальный префикс (77:01:0001005 — объекты квартала по мере ввода) и сплошные цифры без разделителей; find возвращает точный объект по полному номеру. Ответ — кадастровый объект: адрес и данные ГКО (тип, площадь, этажность, год постройки, материал стен, кадастровая стоимость, даты).

Тарификация — за запрос из пакета (4 коп/запрос, пакеты — в личном кабинете), в дневной лимит подсказок не входит. Доступен только по секретному ключу (серверные вызовы). Кадастровый номер в обычных адресных подсказках и прямой ввод кадастрового номера в /v1/suggest/address — на тарифе «Бизнес».

Необязательные флаги в теле запроса: include_codes: true добавляет к каждому объекту числовые коды-классификаторы (type_code, purpose_code, wall_material_code, cost_unit_code и др.); include_detail: true — реквизиты документа об утверждении стоимости (approval_doc). suggest также принимает locations/locations_boost для гео-предпочтения и понимает текст адреса (подсказки только среди объектов с кадастровым номером).

POST /v1/suggest/cadastre   // по мере ввода: полный номер / квартал / сплошные цифры
POST /v1/find/cadastre  // точный объект по полному номеру

// тело одинаково для обоих методов
{
  "query": "77:01:0001005:1022",
  "count": 5
}

// suggest также понимает:
"77:01:0001005"    // квартальный префикс → объекты квартала
"770100010051022"  // сплошные цифры — двоеточия не обязательны

Точный объект по номеру · find/cadastre

POST /v1/find/cadastre
{ "query": "77:01:0001005:1024" }

Поля ответа

ПолеТипОписание
suggestionsarrayНайденные объекты недвижимости.
suggestions[].cadastral_numstringКадастровый номер объекта.
suggestions[].valuestringАдрес объекта (краткая форма).
suggestions[].fullstringАдрес объекта с индексом (полная форма).
suggestions[].address_notestring Оригинальный текст адреса из ЕГРН с пространственным контекстом (ориентир, «примыкает к…», «в N м от…»). Присутствует только у объектов без обычного адреса (например, участки, заданные относительно ориентира); для обычных адресов поле отсутствует.
suggestions[].levelstringУровень адреса (house, flat и т.п.).
suggestions[].federal_districtstringФедеральный округ.
suggestions[].typestringТип объекта: Здание, Помещение, Сооружение, Земельный участок и т.п.
suggestions[].assignationstringНазначение объекта (например, «Нежилое здание»).
suggestions[].object_namestringНаименование объекта; null, если не задано.
suggestions[].areanumberПлощадь объекта, м².
suggestions[].floorsintegerЧисло надземных этажей.
suggestions[].underground_floorsintegerЧисло подземных этажей.
suggestions[].year_builtintegerГод постройки.
suggestions[].year_commissionedintegerГод ввода в эксплуатацию.
suggestions[].wall_materialstringМатериал стен (например, «Кирпичные»).
suggestions[].costnumberКадастровая стоимость объекта, ₽.
suggestions[].cost_per_unitnumberКадастровая стоимость за м², ₽.
suggestions[].cost_datestringДата определения стоимости (ГГГГ-ММ-ДД).
suggestions[].cost_approval_datestringДата утверждения стоимости.
suggestions[].cadastral_blockstringКадастровый квартал.
suggestions[].parent_parcel_numstringКадастровый номер родительского участка.
suggestions[].registered_atstringДата постановки на кадастровый учёт.
suggestions[].cancelled_atstringДата снятия с учёта; null — объект действующий.
suggestions[].purposestring Назначение объекта (для зданий и помещений; для участков — вид разрешённого использования).
suggestions[].cost_unitstringЕдиница измерения кадастровой стоимости.
suggestions[].cost_application_datestringДата начала применения кадастровой стоимости.
suggestions[].fias_guidstringИдентификатор адреса объекта в ФИАС (GUID).
suggestions[].matchnumber Релевантность совпадения 0..1 (по точному кадастровому номеру — 1.0).