Кадастр
Кадастровый поиск
POST/v1/suggest/cadastre
Подсказки объектов недвижимости по кадастровому номеру: понимает полный номер, квартальный префикс (77:01:0001005 — объекты квартала по мере ввода) и сплошные цифры без разделителей. Ответ — краткий профиль объекта: адрес и часть данных ГКО (набор полей зависит от типа объекта).
Тарификация — за запрос из пакета (4 коп/запрос, пакеты — в личном кабинете), в дневной лимит подсказок не входит. Доступен только по секретному ключу (серверные вызовы). Кадастровый номер в обычных адресных подсказках и прямой ввод кадастрового номера в /v1/suggest/address — на тарифе «Бизнес».
Необязательные флаги в теле запроса: include_codes: true добавляет к каждому объекту числовые коды-классификаторы (type_code, purpose_code, wall_material_code, cost_unit_code и др.); include_detail: true — реквизиты документа об утверждении стоимости (approval_doc). Вместе оба флага возвращают в подсказке полную карточку объекта — тот же набор полей, что у объекта по номеру. Также принимает locations/locations_boost для гео-предпочтения и понимает текст адреса (подсказки только среди объектов с кадастровым номером).
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| queryrequired | string | Кадастровый номер (полный или квартальный префикс) или сплошные цифры без разделителей. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/cadastre // по мере ввода: полный номер / квартал / сплошные цифры
{
"query": "77:01:0001005:1022",
"count": 5
}
// также понимает:
"77:01:0001005" // квартальный префикс → объекты квартала
"770100010051022" // сплошные цифры — двоеточия не обязательныПоля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные объекты недвижимости. |
| suggestions[].cadastral_num | string | Кадастровый номер объекта. |
| suggestions[].value | string | Адрес объекта (краткая форма). |
| suggestions[].full | string | Адрес объекта с индексом (полная форма). |
| suggestions[].level | string | Уровень адреса (house, flat и т.п.). |
| suggestions[].is_active | bool | Признак действующего объекта: true — объект не снят с кадастрового учёта. |
| suggestions[].federal_district | string | Федеральный округ. |
| suggestions[].type | string | Тип объекта: Здание, Помещение, Сооружение, Земельный участок и т.п. |
| suggestions[].purpose | string | Назначение объекта (для зданий и помещений). |
| suggestions[].assignation | string | Назначение объекта (например, «Нежилое здание»). |
| suggestions[].category | string | Категория земель — для земельных участков (например, «Земли населённых пунктов»). |
| suggestions[].land_use | string | Вид разрешённого использования — для земельных участков. |
| suggestions[].area | number | Площадь объекта, м². |
| suggestions[].cost | number | Кадастровая стоимость объекта, ₽. |
| suggestions[].cost_per_unit | number | Кадастровая стоимость за м², ₽. |
| suggestions[].floors | integer | Число надземных этажей. |
| suggestions[].year_built | integer | Год постройки. |
| suggestions[].wall_material | string | Материал стен (например, «Кирпичные»). |
| suggestions[].registered_at | string | Дата постановки на кадастровый учёт. |
| suggestions[].egrn_status | string | Статус в ЕГРН: учтённый, ранее учтённый, временный, архивный. |
| suggestions[].match | number | Релевантность совпадения 0..1 (по точному кадастровому номеру — 1.0). |
| suggestions[].address_note | string | Оригинальный текст адреса из ЕГРН с пространственным контекстом (ориентир, «примыкает к…», «в N м от…»). Присутствует только у объектов без обычного адреса (например, участки, заданные относительно ориентира); для обычных адресов поле отсутствует. |
Объект по кадастровому номеру
POST/v1/find/cadastre
Возвращает точный объект недвижимости по полному кадастровому номеру. Ответ — полная карточка: адрес и данные ГКО (тип, площадь, этажность, год постройки, материал стен, кадастровая стоимость, даты).
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| queryrequired | string | Полный кадастровый номер. |
| count | integer | Сколько записей вернуть, если по номеру найдено несколько (по умолчанию 10). |
POST /v1/find/cadastre
{ "query": "77:01:0001005:1024" }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные объекты недвижимости. |
| suggestions[].cadastral_num | string | Кадастровый номер объекта. |
| suggestions[].value | string | Адрес объекта (краткая форма). |
| suggestions[].full | string | Адрес объекта с индексом (полная форма). |
| suggestions[].address_note | string | Оригинальный текст адреса из ЕГРН с пространственным контекстом (ориентир, «примыкает к…», «в N м от…»). Присутствует только у объектов без обычного адреса (например, участки, заданные относительно ориентира); для обычных адресов поле отсутствует. |
| suggestions[].level | string | Уровень адреса (house, flat и т.п.). |
| suggestions[].is_active | bool | Признак действующего объекта: true — объект не снят с кадастрового учёта. |
| suggestions[].federal_district | string | Федеральный округ. |
| suggestions[].type | string | Тип объекта: Здание, Помещение, Сооружение, Земельный участок и т.п. |
| suggestions[].assignation | string | Назначение объекта (например, «Нежилое здание»). |
| suggestions[].object_name | string | Наименование объекта; null, если не задано. |
| suggestions[].area | number | Площадь объекта, м². |
| suggestions[].floors | integer | Число надземных этажей. |
| suggestions[].underground_floors | integer | Число подземных этажей. |
| suggestions[].year_built | integer | Год постройки. |
| suggestions[].year_commissioned | integer | Год ввода в эксплуатацию. |
| suggestions[].wall_material | string | Материал стен (например, «Кирпичные»). |
| suggestions[].cost | number | Кадастровая стоимость объекта, ₽. |
| suggestions[].cost_per_unit | number | Кадастровая стоимость за м², ₽. |
| suggestions[].cost_date | string | Дата определения стоимости (ГГГГ-ММ-ДД). |
| suggestions[].cost_approval_date | string | Дата утверждения стоимости. |
| suggestions[].cadastral_block | string | Кадастровый квартал. |
| suggestions[].parent_parcel_num | string | Кадастровый номер родительского участка. |
| suggestions[].registered_at | string | Дата постановки на кадастровый учёт. |
| suggestions[].cancelled_at | string | Дата снятия с учёта; null — объект действующий. |
| suggestions[].purpose | string | Назначение объекта (для зданий и помещений; для участков — вид разрешённого использования). |
| suggestions[].cost_unit | string | Единица измерения кадастровой стоимости. |
| suggestions[].cost_application_date | string | Дата начала применения кадастровой стоимости. |
| suggestions[].fias_guid | string | Идентификатор адреса объекта в ФИАС (GUID). |
| suggestions[].egrn_status | string | Статус в ЕГРН: учтённый, ранее учтённый, временный, архивный. |
| suggestions[].cost_registration_date | string | Дата внесения кадастровой стоимости в ЕГРН. Тарифы «Расширенный» и выше. |
| suggestions[].related_cad_nums | object | Связанные объекты — списки кадастровых номеров по ключам: prev — из чего образован, next — что образовано из него (до 1000 номеров), inner — что расположено на объекте, united — единое землепользование или объединяющий объект, facility — сооружение-комплекс, intersected — пересекающие объекты. Ключ без номеров не приходит. Тарифы «Расширенный» и выше. |
| suggestions[].land_subtype | string | Вид земельного участка (землепользование, единое землепользование, многоконтурный). Тарифы «Расширенный» и выше. |
| suggestions[].area_declared | number | Декларированная площадь участка, м². Тарифы «Расширенный» и выше. |
| suggestions[].built_up_area | number | Площадь застройки сооружения, м². Тарифы «Расширенный» и выше. |
| suggestions[].extension | number | Протяжённость сооружения (сети, дороги), м. Тарифы «Расширенный» и выше. |
| suggestions[].depth | number | Глубина сооружения, м. Тарифы «Расширенный» и выше. |
| suggestions[].height | number | Высота сооружения, м. Тарифы «Расширенный» и выше. |
| suggestions[].volume | number | Объём сооружения, м³. Тарифы «Расширенный» и выше. |
| suggestions[].readiness_pct | integer | Степень готовности объекта незавершённого строительства, %. Тарифы «Расширенный» и выше. |
| suggestions[].ownership | string[] | Форма собственности. Тарифы «Бизнес» и «Корпоративный». |
| suggestions[].right_type | string[] | Вид зарегистрированного права. Тарифы «Бизнес» и «Корпоративный». |
| suggestions[].cultural_heritage | object | Объект культурного наследия: number — регистрационный номер, kind — вид, name — наименование. Тарифы «Бизнес» и «Корпоративный». |
| suggestions[].match | number | Релевантность совпадения 0..1 (по точному кадастровому номеру — 1.0). |