API – Исполнительные производства

Исполнительные производства, открытые в отношении российских организаций, по данным Федеральной службы судебных приставов.




Формат запроса

Используются GET- или POST-запросы следующего вида

https://api.ofdata.ru/alpha/json
  ?object=efp
  &key={ваш API-ключ}
  &ogrn={ОГРН организации}
  &inn={ИНН организации}
  &kpp={КПП организации}
  &limit={лимит записей}
  &offset={смещение}
  &sort={сортировка}


Параметр запроса Описание
object
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение
efp
.
key
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации.
ogrn
Рекомендуемый параметр, ОГРН организации, 13 цифр. Служит уникальным идентификатором для всех организаций.
inn
Если вы не указали ОГРН, вы можете указать ИНН организации. В случае определения нескольких юридческих лиц с указанным ИНН (такое бывает, например, если у организации есть филиалы), будет возвращена информация по головной организации.
kpp
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию.
limit
Ограничение количества записей об исполнительных производствах в ответе, необязательный параметр. Значение по умолчанию:
100
, максимальное значение параметра:
100
.
offset
Смещение выборки записей об исполнительных производствах в ответе, необязательный параметр. Обычно используется совместно с параметром
limit
. Значение по умолчанию:
0
.
sort
Указывает, как должна осуществляться сортировка записей об исполнительных производствах в ответе, необязательный параметр. По умолчанию, записи сортируются по ключу
initiation_date
по возрастанию. Чтобы отсортировать записи по убыванию, укажите
sort=-initiation_date
.



Формат ответа

{
  "data": {
Основная информация ответа
    "enforcement_proceedings": [ {
Исполнительные производства в отношении организации
      "debtor_name": <STRING>,
Наименование организации-должника
      "debtor_address": <STRING>,
Адрес организации-должника
      "number": <STRING>,
Номер исполнительного производства
      "initiation_date": <STRING>,
Дата возбуждения исполнительного производства
      "executive_document": {
Исполнительный документ
        "number": <STRING>,
Номер исполнительного документа
        "type": <STRING>,
Тип исполнительного документа
        "date": <STRING>,
Дата исполнительного документа
        "object": <STRING>
Требования исполнительного документа
      },
      "execution_object": <STRING>,
Предмет исполнения
      "department_of_bailiffs_name": <STRING>,
Наименование отдела судебных приставов
      "department_of_bailiffs_address": <STRING>,
Адрес отдела судебных приставов
      "debt_amount": <INTEGER>,
Сумма долга, руб.
      "debt_remaining": <INTEGER>,
Остаток непогашенной задолженности, руб.
      "is_completed": <BOOLEAN>,
Признак окончания или прекращения исполнительного производства
      "completion_date": <STRING>,
Дата окончания или прекращения исполнительного производства
      "completion_reason": <STRING>
Причина окончания или прекращения исполнительного производства
    }, ... ],
    "entity": {
Организация, определенная по ОГРН или ИНН
      "ogrn": <STRING>,
ОГРН
      "inn": <STRING>,
ИНН
      "kpp": <STRING>,
КПП
      "name": <STRING>,
Сокращенное наименование
      "full_name": <STRING>,
Полное наименование
      "region_code": <STRING>,
Код региона
      "legal_address": <STRING>,
Юридический адрес
      "ogrn_date": <STRING>,
Дата присвоения ОГРН
      "liquidation_date": <STRING>
Дата ликвидации юридического лица
    }
  },
  "meta": {
Информация о результате запроса
    "status": <STRING>,
Статус ответа, принимает значения
ok
или
error
    "message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
    "today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
  }
}


Примечания


Если у вас есть идеи по улучшению API или какие-либо вопросы — пишите нам на [email protected] или оставьте сообщение через форму обратной связи. Мы постоянно совершенствуем наши сервисы и с удовольствием рассмотрим все ваши предложения.