Войти

Получить сведения о недвижимости через REST API с идентификатором согласия

Дата актуализации 24.04.2026


Назначение

Получение сведений всех документов гражданина по идентификатору пользователя (oid) и типу документа (doc_type)

Тип запроса

GET

Path

/digital/api/public/commercial/{version}/pso/{oid}/doc/ REG_REALESTATE

Авторизация

Указать в заголовке запроса поле «Authorization» с полученным маркером доступа, содержащим информацию о действующем согласии

Параметры запроса в path

– version – версия API (текущая версия – v1);

– oid – уникальный идентификатор пользователя;

– doc_type – REG_REALESTATE

Параметры запроса в query – permissionId -  идентификатор выданного согласия пользователя ЕСИА для внешней ИС;
– test={id}, где id – порядковый номер тестового ответа для конкретного сведения.
Модель документа Сведения о недвижимости
Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/commercial/v1/pso/2079991302/doc/REG_REALESTATE?permissionId=125478596'

--header 'Authorization: Bearer token'

Примеры ответов:


Пример ответа с данными

{
    "id": "119bb4b1-7e54-4f13-b113-bf0c0b4739e4",
    "oid": "2079991302",
    "updatedOn": 1742215154392,
    "status": "verified_by_request",
    "relevance": "actual",
    "departmentDoc": "Росреестр",
    "version": 2,
    "type": "REG_REALESTATE",
    "data": [
        {
            "id": "119bb4b1-7e54-4f13-b113-bf0c0b4739e4",
            "propertyTypeValue": "Помещение",
            "cadNumber": "32:28:0032801:1152",
            "readableAddress": "Брянская область, г Брянск, пр-кт Станке Димитрова, д 57А, кв 66",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/119bb...;
        },
        {
            "id": "28e6033c-dea0-40b9-b40a-73f0f56cc305",
            "propertyTypeValue": "Машино-место",
            "cadNumber": "72:23:0103002:12137",
            "readableAddress": "Российская Федерация, Тюменская область, городской округ город Тюмень, город Тюмень, улица Алматинская, дом 2, машино-место 291",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/28e60...;
        },
        {
            "id": "cae0dbd7-e992-4060-ad96-c16cbd02535c",
            "propertyTypeValue": "Объект незавершенного строительства",
            "cadNumber": "30:01:150301:2583",
            "readableAddress": "Астраханская область, р-н Ахтубинский, г Ахтубинск, ул Халтурина, д 16",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/cae0d...;
        },
        {
            "id": "aae8f8c2-f11d-4357-a03b-d6b55c3d88ef",
            "propertyTypeValue": "Здание",
            "cadNumber": "61:01:0170102:7130",
            "readableAddress": "Ростовская область, р-н. Азовский, с. Самарское, пер. Кооперативный, д. 20",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/aae8f...;
        },
        {
            "id": "c3e3a1ae-dd32-4b6a-9ca9-ceee52285c33",
            "propertyTypeValue": "Предприятие как имущественный комплекс",
            "cadNumber": "0:0:0:2332",
            "readableAddress": "г.Москва, Мичуринский проспект, д.7, кв. 378",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/c3e3a...;
        },
        {
            "id": "34284149-f7fe-482e-bbec-140d4c120431",
            "propertyTypeValue": "Земельный участок",
            "cadNumber": "05:50:000043:107",
            "readableAddress": "Республика Дагестан, р-н Кумторкалинский, с Учкент",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/34284...;
        },
        {
            "id": "488f83ab-252c-4af3-9fcb-923b54f0c4b8",
            "propertyTypeValue": "Единый недвижимый комплекс",
            "cadNumber": "24:50:0500125:331",
            "readableAddress": "Российская Федерация, Красноярский край, г. Красноярск, ул. Крайняя",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/488f8...;
        },
        {
            "id": "be56665c-d640-4628-974b-ab5a0d58b981",
            "propertyTypeValue": "Сооружение",
            "cadNumber": "47:22:0336002:83",
            "readableAddress": "Ленинградская область, Волосовский район, пос. Сяглицы, д. 14",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/be566...;
        },
        {
            "id": "7e60b91d-3368-402a-b5e6-a0dd1928cd79",
            "propertyTypeValue": "Земельный участок",
            "cadNumber": "23:43:0202046:6",
            "readableAddress": "Краснодарский край, г. Краснодар, ул. Парковая, уч. 38",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/7e60b...;
        },
        {
            "id": "f8eb3f57-7f10-4d7a-8ac5-6e659ab0fb69",
            "propertyTypeValue": "Помещение",
            "cadNumber": "77:09:0001014:6102",
            "readableAddress": "Российская Федерация, город Москва, вн.тер.г. муниципальный округ Головинский, улица Флотская, дом 74, квартира 27",
            "fileLink": "https://esia.test.gosuslugi.ru/digital/api/public/v1/pso/2079991302/doc/reg_realestate/f8eb3...;
        }
    ]
}


Пример ответа - Данные отсутствуют

{
    "oid": "2079991302",
    "requestId": "5010005157"
}


Пример ответа - Запрос сведений в Росреестре

{
    "oid": "2079991302",
    "requestId": "5010005157"
}


Пример ответа - Ошибка при запросе 

{
    "id": "5e18f8f2-6183-45ae-9c00-970e375f2c9f",
    "oid": "2079991302",
    "updatedOn": 1742291210378,
    "status": "unverified",
    "relevance": "invalid",
    "departmentDoc": "Росреестр",
    "version": 1,
    "type": "REG_REALESTATE",
    "data": [],
    "errorUpdatedOn": 1742291210295,
    "error": "Data collection error."
}


Пример ответа - нет согласия пользователя
{
    "oid": "2079991302",
    "statusDoc": "NO_CONSENT"
}

Пример ответа - ошибка 403 - заблокирован доступ к REST API
HTTP Status Code: 403 Forbiden
{
    "message": "Доступ к данным ограничен. Необходимо снять ограничение доступа для коммерческой организации со стороны МЦ"
}

Тестирование

Также для сведений реализована возможность получения предопределенных, тестовых ответов, «заглушек» в интеграционной среде ЕСИА и ЦП (https://esia-portal1.test.gosuslugi.ru/). Для того, чтобы при вызове метода возвращались тестовые данные, необходимо дополнительно указывать в запросе параметр test={id}, где id – порядковый номер тестового ответа для конкретного сведения
Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/commercial/v1/pso/2181502158/doc/REG_REALESTATE?test=1&permissionId=125478596'

--header 'Authorization: Bearer token'


Параметр Описание
 ?test=1  Сведения о недвижимости пользователя с двумя объектами
 ?test=2  Сведения об отсутствии недвижимости у пользователя

Авторизуйтесь, чтобы оставить комментарий к статье