POST /checks

Метод позволяет отправить запрос на проверку данных

Заголовки

Название Описание
Content-Type Тип контента: application/json
Authorization Заголовок авторизации

Тело запроса

Запрос должен содержать объект Check

Название Тип Формат Обязательность Описание
correlationId string ^\w{1,256}$ false Идентификатор группы отправленных запросов. Заполняется клиентом. Используется для связи нескольких запросов. По нему можно искать запросы
externalId string ^\w{1,256}$ false Клиентский идентификатор проверки. Заполняется клиентом. Система контролирует уникальность идентификатора. Необходим для дедубликации запросов. По нему можно искать запросы
fssp object Fssp false Проверка исполнительных производств в ФССП
courts object Court false Проверка на наличие судов общей юрисдикции
arbitration object Arbitration false Проверка арбитражных дел
bankruptcy object Bankruptcy false Проверка на наличие процедуры банкротства
rosfinmonitoring object Rosfinmonitoring false Проверка на наличие субъекта в списках Росфинмониторинга (террористы и экстремисты, распространители массового оружия)
passport object Passport false Проверка реквизитов паспорта
snils object Snils false Проверка СНИЛС в базе ПФР на соответствие ФИО и дате рождения
commercialActivity object CommercialActivity false Проверка на наличие коммерческой деятельности у физического лица
powerOfAttorney object PowerOfAttorney false Проверка доверенности на действительность
realEstateInfo object RealEstateInfo false Проверка базовых характеристик объекта недвижимости
realEstateOwnership object RealEstateOwnership false Проверка истории владения объектом недвижимости
realEstateRenovation object RealEstateRenovation false Проверка объекта недвижимости на вхождение в программу реновации
cadastralMap object CadastralMap false Получение информации об объекте недвижимости из публичной кадастровой карты Росреестра
breakdown object Breakdown false Проверка многоквартирного дома на аварийность
utilityBill object UtilityBill false Проверка на наличие задолженности по коммунальным услугам (доступна только для Москвы и области, Санкт-Петербурга и области)
inheritance object Inheritance false Поиск наследственного дела по реестру наследственных дел ФНП
pledge object Pledge false Проверка по реестру залогов движимого имущества
organizationInfo object OrganizationInfo false Базовая проверка юридического лица
wanted object Wanted false Проверка физлица на нахождение в розыске
error object Error false Описание ошибки, которая произошла во время получения проверки

В объекте должны быть описаны данные для проверки, которую необходимо совершить. В одном запросе может содержаться только одна проверка. Для группировки проверок используйте correlationId

Пример

  POST /realty/assessment/v1/checks
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
  Content-Type: application/json
{
    "corelationId": "fc88aa01-c2f2-4498-bbb2-5c7218e69585",
    "externalId": "4f8e9e60-74f9-4e00-9fae-abf021ea0314",
    "fssp": {
        "subjectId": "3f813a2f-958b-499b-90c7-a038d98955c0",
        "regions": [
            "54",
            "77"
        ]
    }
}

Ответы

201

Тело ответа

Проверка успешно создана. В теле ответа содержится описание проверки Check

Заголовки ответа

Название Описание
Content-Type Тип контента: application/json

Пример ответа

  HTTP 201
  Content-Type: Application/json
{
    "checkId": "7720902d-b025-4d9b-92a1-288a61e09b9d",
    "corelationId": "fc88aa01-c2f2-4498-bbb2-5c7218e69585",
    "externalId": "4f8e9e60-74f9-4e00-9fae-abf021ea0314",
    "checkType": "Fssp",
    "checkState": "Processing",
    "creationDate": "2011-01-01T15:03:01.012345Z",
    "fssp": {
        "subjectId": "3f813a2f-958b-499b-90c7-a038d98955c0",
        "regions": [
            "54",
            "77"
        ]
    }
}

400

Ошибки валидации запроса. В теле ответа содержится описание ошибки Error. Для данного метода возможны следующие ошибки:

Код ошибки Описание
WrongFieldValue Значение поля не соответствует требуемому формату. Поле, формат которого не соответствует, указано в описании ошибки в message
AbsenceOfRequiredField Отсутствует одно из обязательных полей
DuplicatedExternalId Указанный в запросе внешний идентификатор уже был использован ранее
UnexistentSubject Указанный идентификатор субъекта не существует
UnsupportedSubjectType Некорректный тип субъекта
UnsupportedRegion Проверка недоступна для данного региона
NotaryNotFound По указанному Id нотариус не найден

Пример ответа

  HTTP 400
  Content-Type Application/json
{
    "code": "validation",
    "message": "Failed to validate request",
    "target": "api",
    "errors": [
        {
            "code": "AbsenceOfRequiredField",
            "message": "SubjectId is required",
            "target": "AssessmentApi"
        }
    ]
}

401

Ошибка авторизации: пользователь не авторизован

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации

415

В заголовке Content-Type указан тип контента, который не поддерживается для данного метода

429

Слишком много параллельных запросов (больше 10 запросов в секунду)