Дата актуализации 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' |
Примеры ответов:
Пример ответа с данными
|
{ |
Пример ответа - Данные отсутствуют
|
{ |
Пример ответа - Запрос сведений в Росреестре
|
{ |
Пример ответа - Ошибка при запросе
|
{ |
Пример ответа - нет согласия пользователя
|
{ "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 | Сведения об отсутствии недвижимости у пользователя |