POST /subjects/requisites

Метод позволяет получить реквизиты субъекта (организации или физического лица) на основании его персональных данных. Можно получить следующие реквизиты:

  • ИНН физического лица

Заголовки

Название Описание
Authorization Заголовок авторизации
ContentType Тип контента

Content-Type

Допустимые значения Content-Type:

  • application/json

Тело запроса

Название Тип Формат Обязательность Описание
requisiteType object RequisiteType true Реквизит, который необходимо получить
inn object Inn false Данные необходимые для получения ИНН

RequisiteType

Название Описание
inn ИНН физического лица. Если он указан в requisiteType, то в теле запроса обязательно должен быть указан объект inn

Пример

  POST /entity/v1/subjects/requisites
  Content-Type: Application/json
  Authorization: ReestroAuth apiKey=235dc85c-f7f9-4dc0-8bbf-dad9e0185afd&portal.orgid=1748b89b-7d34-4d47-b479-b06b40ab1a30
{
  "requisiteType": "inn",
  "inn":
  {
    "name": "Анастасия",
    "surname": "Тарасова",
    "patronymic": "Константиновна",
    "dateBirth": "2018-01-01",
    "birthPlace": "Город",
    "identityDocument":
    {
      "documentType": "008001001000",
      "number": "123456",
      "series": "1111",
      "issueDate": "2018-12-12",
      "issuer":
      {
        "issuerCode": "123-123",
        "issuerName": "Орган власти"
      }
    }
  }
}

Ответы

200

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

Тело ответа

Название Тип Формат Обязательность Описание
requisiteType object RequisiteType true Полученный реквизит
inn object Inn false Описание ИНН, если удалось его получить
  HTTP 200
  Content-Type: Application/json
{
  "requisiteType": "inn",
  "inn":
  {
    "name": "Анастасия",
    "surname": "Тарасова",
    "patronymic": "Константиновна",
    "dateBirth": "2018-01-01",
    "birthPlace": "Где то",
    "inn": "140702214133",
    "identityDocument":
    {
      "documentType": "008001001000",
      "number": "123456",
      "series": "1111",
      "issueDate": "2018-12-12",
      "issuer":
      {
        "issuerCode": "123-123",
        "issuerName": "кем-то"
      }
    }
  }
}

400

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

Код ошибки Описание
AbsenceOfRequiredField Не указано одно из обязательных полей
WrongFieldValue Значение поля не соответствует требуемому формату. Поле, формат которого не соответствует, указано в описании ошибки в message

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

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

401

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

403

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

404

По указанным данным не удалось найти искомый реквизит