API ФССП (Федеральная Служба Судебных Приставов)

Документация по работе с API ФССП (Федеральная Служба Судебных Приставов)

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.

История изменений/обновлений API

Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 400 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа

HTTPS GET запрос: https://api-cloud.ru/api/fssp.php
Обязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS.
Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.

type Обязательно	Описание	Параметры в запросе Обязательно
	В одном запросе возможно отправить только 1 тип
regionsList	Получить список регионов для параметра "region" Плата за обработку запроса не списывается.	Обязательные token - персональный ключ API
physical	Отправить запрос на поиск физического лица • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные lastname - Фамилия Разрешено: кирилица, латиница, цифры, знак "-" firstname - Имя Разрешено: кирилица, латиница, цифры, знак "-" birthdate - Дата рождения в формате дд.мм.гггг Разрешено: цифры, знак "." region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") При указании конкретного региона - скорость обработки быстрее Разрешено: цифры, знак "-" token - персональный ключ API Дополнительные secondname - Отчество Разрешено: кирилица, латиница, цифры, знак "-" onlyActual=1 - Фильтр "Только актуальные делопроизводства"
legal	Отправить запрос на поиск юридического лица • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные nameLegal - Имя юридического лица Разрешено: кирилица, латиница, цифры, знак "-" region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") При указании конкретного региона - скорость обработки быстрее Разрешено: кирилица, латиница, цифры, знак "-" token - персональный ключ API Дополнительные address - Адрес юридического лица Разрешено: кирилица, латиница, цифры, знак "-" onlyActual=1 - Фильтр "Только актуальные делопроизводства"
ip	Отправить запрос на поиск по номеру исполнительного производства • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные number - Номер исполнительного документа в формате n…n/yy/dd/rr или n…n/yy/ddddd-ИП Разрешено: кирилица, латиница, цифры, знак "-/" token - персональный ключ API
id	Отправить запрос на поиск по номеру исполнительного документа • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные number - Номер исполнительного производства Разрешено: цифры, знаки "-/" region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") При указании конкретного региона - скорость обработки быстрее Внимание! В данный момент работает корректно только поиск с указанием конкретного региона Разрешено: цифры, знак "-" token - персональный ключ API Дополнительные typeid - ID типа исполнительного документ Список ID Разрешено: цифры
inn	Отправить запрос на поиск юридического лица по ИНН • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные inn - ИНН организации Разрешено: цифры region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") При указании конкретного региона - скорость обработки быстрее Разрешено: цифры, знак "-" token - персональный ключ API Дополнительные onlyActual=1 - Фильтр "Только актуальные делопроизводства"
wanted ^beta	Реестр розыска по исполнительным производствам Максимальное количество загружаемых страниц: 27 • Розыскное дело (№, дата) • Исполнительное производство (№, дата) • Объект розыска • Данные об объявлении розыска должника, его имущества или ребенка • Наименование ОСП, где осуществляется розыск, адрес • Телефон дежурной части ТО ФССП России • Тип дела	Обязательные fio - ФИО розыскиваемого Маска: [A-Za-zА-ЯЁа-яё0-9-\s] token - персональный ключ API Дополнительные region - Номер региона (Поиск по всем регионам производится по умолчанию. Список доступен через тип запроса "regionsList") Маска: [0-9-]
alim ^beta	Реестр должников по алиментным обязательствам • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные lastname - Фамилия Разрешено: кирилица, латиница, цифры, знак "-" firstname - Имя Разрешено: кирилица, латиница, цифры, знак "-" birthdate - Дата рождения в формате дд.мм.гггг Разрешено: цифры, знак "." region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") При указании конкретного региона - скорость обработки быстрее Разрешено: цифры, знак "-" token - персональный ключ API Дополнительные secondname - Отчество Разрешено: кирилица, латиница, цифры, знак "-" onlyActual=1 - Фильтр "Только актуальные делопроизводства"

Токен (token) можно передавать в заголовках (headers). Указываем в заголовке Token: ВАШ_ТОКЕН

Пример отправки GET запроса на PHP:

function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,400); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ 
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/fssp.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)

Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.

Примеры запросов

Запрос на поиск физического лица

Пример запроса "Запрос на поиск физического лица" HTTP GET на URL нашего API

https://api-cloud.ru/api/fssp.php?type=physical&lastname=ФАМИЛИЯ&firstname=ИМЯ&secondname=ОТЧЕСТВО&birthdate=ДАТА_РОЖДЕНИЯ&region=НОМЕР_РЕГИОНА&token=53ba1b7a55********a97eff3a5220792

Пример успешного запроса по типу physical с сайта ФССП в формате JSON

{
  "status": 200, // Статус запрос
  "countAll":"53", // Всего записей
  "pagesAll":"3", // Всего страниц найдено
  "count": 1, // Количество записей в результате
  "totalLoadedPage": 3, // Загружено страниц в результате (по умолчанию загружается 25 страниц)
  "onlyActual":0, // Активность фильтра "Только актуальные делопроизводства" 
	// Результат
  "records": [
    {
      "debtor_name": "ФИО", // ФИО должника
      "debtor_address": "РОССИЯ *********************", // Место рождения
      "debtor_dob": "31.03.****", // Дата рождения
      "process_title": "197****/21/*****-ИП", // Номер исполнительного производства
      "process_date": "26.11.2021", // Дата начала делопроизводства
      "process_total": "270000/00/54007-СД", // Сводное исполнительное производство
      "recIspDoc": "Судебный приказ от 27.07.2021 № 2А-1****/**** СУДЕБНЫЙ УЧАСТОК № **** *********** ВНУТРИГОРОДСКОГО ОКРУГА Г. *******", // Реквизиты исполнительного документа (вид, дата принятия органом, номер, наименование органа, выдавшего исполнительный документ)
      
      // Реквизиты исполнительного документа 
      "recIspDocDetail": [
        "doc_organization": "СУДЕБНЫЙ УЧАСТОК № **** *********** ВНУТРИГОРОДСКОГО ОКРУГА Г. *******", // наименование органа, выдавшего исполнительный документ
        "doc_claimer_inn": "11111111111", // ИНН взыскателя-организации
        "doc_type": "Судебный приказ", // вид
        "doc_date": "27.07.2021", // дата принятия органом
        "document_num": "2А-1****/****" // Номер документа
      ],
      "stopIP": "23.08.2024, ст. 46, ч. 1, п. 3", // Дата, причина окончания или прекращения ИП, статья, часть, пункт основания
      "stopIPDate": "23.08.2024", // Дата, причина окончания или прекращения ИП
      "stopIPReason": "ст. 46, ч. 1, п. 3", // статья, часть, пункт основания
      "subject": "Взыскание налогов и сборов, включая пени (кроме таможенных)", // Вид взыскания (Предмет исполнения)
      // Массив с предметами погашения и не погашенной задолженности
      "subjectArray": [
        {
          "title": "Задолженность по кредитным платежам (кроме ипотеки)", // Наимнование
          "sum": " 18422.50 руб." // Сумма
        },
        {
          "title": "Исполнительский сбор", // Наимнование
          "sum": " 1605.62 руб." // Сумма
        }
      ],
      "sum": "20028.12", // Общая сумма непогашенной задолженности
      "document_organization": "ОСП по ************* г. **** *****, г. *************", // Отдел судебных приставов
      
      "department_title": "ОСП по Куйбышевскому и Барабинскому районам", // Наименование отдела судебных приставов
      "department_address": "632387, Россия, Новосибирская обл., Куйбышевский р-н, г. Куйбышев, , ул. Краскома, д. 1, ,", // Адрес отдела судебных приставов
      
      "document_type": "Судебный приказ", // Вид исполнительного документа
      "officer_name": "********* О. О.", // Пристав
	  // Контакты пристава
      "officer_phones": [
        [
          "+786*********"
        ]
      ],
    }
  ]
  // Информация о запросе
    "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если неверно переданы данные или результат не найден

{
  "status":200,
  "count":0,
  "message":"В базе ФССП отсутствует",
  "inquiry":
  {
    "price":1.4,
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed":3,
    "attempts":1
  }
}

Запрос на поиск юридического лица

Пример запроса "Запрос на поиск юридического лица" HTTP GET на URL нашего API

https://api-cloud.ru/api/fssp.php?type=legal&name=аптека 23&region=23&adress=Сочи&token=53ba1b7a55a*****97eff3a5220792

Пример успешного запроса по типу legal с сайта ФССП в формате JSON

 {
  "status": 200, // Статус запроса
  "countAll":"53", // Всего записей
  "pagesAll":"3", // Всего страниц найдено
  "count": 1, // Количество записей в результате
  "totalLoadedPage": 3, // Загружено страниц в результате (по умолчанию загружается 25 страниц)
  "onlyActual":0, // Активность фильтра "Только актуальные делопроизводства" 
  // Результат
  "records": [
    {
      "debtor_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АПТЕКА-23\"", // Наименование
      "debtor_address": " РОССИЯ,353560,КРАСНОДАРСКИЙ КРАЙ, СОЧИ Г, КОВТЮХА УЛ,14", // Адрес
      "debtor_dob": "1111111111", // ИНН
      "process_title": "9**95/20/2**60-ИП", // Номер исполнительного производства
      "process_date": "23.10.2020", // Дата исполнительного производства
      "process_total": "270000/00/54007-СД", // Сводное исполнительное производство
      "recIspDoc": "Исполнительный лист от 23.07.2021 № ФС 039022227 ЯКУТСКИЙ ГОРОДСКОЙ СУД 1435149791", // Реквизиты исполнительного документа
      
      // Реквизиты исполнительного документа 
      "recIspDocDetail": [
        "doc_organization": "ЯКУТСКИЙ ГОРОДСКОЙ СУД", // наименование органа, выдавшего исполнительный документ
        "doc_claimer_inn": "1435149791", // ИНН взыскателя-организации
        "doc_type": "Исполнительный лист", // вид
        "doc_date": "23.07.2021", // дата принятия органом
        "document_num": "ФС 039022227" // Номер документа
      ],
      "stopIP": "23.08.2024, ст. 46, ч. 1, п. 3", // Дата, причина окончания или прекращения ИП, статья, часть, пункт основания
      "stopIPDate": "23.08.2024", // Дата, причина окончания или прекращения ИП
      "stopIPReason": "ст. 46, ч. 1, п. 3", // статья, часть, пункт основания
      "subject": "Взыскание налогов и сборов, включая пени",
      // Массив с предметами погашения и не погашенной задолженности
      "subjectArray": [
        {
          "title": "Задолженность по кредитным платежам (кроме ипотеки)", // Наимнование
          "sum": " 18422.50 руб." // Сумма
        },
        {
          "title": "Исполнительский сбор", // Наимнование
          "sum": " 1605.62 руб." // Сумма
        }
      ],
      "sum": "20028.12", // Общая сумма непогашенной задолженности
      "document_organization": "ОСП по ************* г. **** *****, г. *************", // Отдел судебных приставов
      
      "department_title": "ОСП по Куйбышевскому и Барабинскому районам", // Наименование отдела судебных приставов
      "department_address": "632387, Россия, Новосибирская обл., Куйбышевский р-н, г. Куйбышев, , ул. Краскома, д. 1, ,", // Адрес отдела судебных приставов
      
      "document_type": "Судебный приказ", // Вид исполнительного документа
      "officer_name": "********* О. О.", // Пристав
      "officer_phones": [
        [
          " +7(86**6)2-33-**",
          "+7(8***6)4-**-*7"
        ]
      ]
    }
  ]
 }

Если неверно переданы данные или результат не найден

{
  "status":200,
  "count":0,
  "message":"В базе ФССП отсутствует",
  "inquiry":
  {
    "price":1.4,
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed":3,
    "attempts":1
  }
}

Запрос на поиск по номеру исполнительного производства

Пример запроса "Запрос на поиск по номеру исполнительного производства" HTTP GET на URL нашего API

https://api-cloud.ru/api/fssp.php?type=ip&number=3***2/17/23072-ИП&token=53ba1b7a55abb*****7eff3a5220792

Пример успешного запроса по типу ip с сайта ФССП в формате JSON

{
  "status": 200, // Статус запроса
  "count": 1, // Количество записей
  // Найденные записи
  "records": [
    {
      "debtor_name": "ООО \"АПТЕКА \"АРЕДА\"", // Наименование
      "debtor_address": " 354003,23, СОЧИ Г, ТРУДА УЛ,14,А", // Адрес
      "debtor_dob": "1111111111", // ИНН или Дата рождения
      "process_title": "32472/17/23072-ИП", // Номер исполнительного делопроизводства
      "process_date": "18.05.2017 1555/19/23072-СД", // Дата постановления
      "process_total": "270000/00/54007-СД", // Сводное исполнительное производство
      "recIspDoc": "Исполнительный лист от 23.07.2021 № ФС 039047327 ЯКУТСКИЙ ГОРОДСКОЙ СУД 1435149791", // Реквизиты исполнительного документа
      
      // Реквизиты исполнительного документа 
      "recIspDocDetail": [
        "doc_organization": "ЯКУТСКИЙ ГОРОДСКОЙ СУД", // наименование органа, выдавшего исполнительный документ
        "doc_claimer_inn": "1435149791", // ИНН взыскателя-организации
        "doc_type": "Исполнительный лист", // вид
        "doc_date": "23.07.2021", // дата принятия органом
        "document_num": "ФС 039022227" // Номер документа
      ],
      "stopIP": "23.08.2024, ст. 46, ч. 1, п. 3", // Дата, причина окончания или прекращения ИП, статья, часть, пункт основания
      "stopIPDate": "23.08.2024", // Дата, причина окончания или прекращения ИП
      "stopIPReason": "ст. 46, ч. 1, п. 3", // статья, часть, пункт основания
      "subject": "Взыскание налогов и сборов, включая пени", // Вид
      // Массив с предметами погашения и не погашенной задолженности
      "subjectArray": [
        {
          "title": "Задолженность по кредитным платежам (кроме ипотеки)", // Наимнование
          "sum": " 18422.50 руб." // Сумма
        },
        {
          "title": "Исполнительский сбор", // Наимнование
          "sum": " 1605.62 руб." // Сумма
        }
      ],
      "sum": "20028.12", // Общая сумма непогашенной задолженности
      "document_organization": "ОСП по ************* г. **** *****, г. *************", // Отдел судебных приставов
      
      "department_title": "ОСП по Куйбышевскому и Барабинскому районам", // Наименование отдела судебных приставов
      "department_address": "632387, Россия, Новосибирская обл., Куйбышевский р-н, г. Куйбышев, , ул. Краскома, д. 1, ,", // Адрес отдела судебных приставов
      
      "document_type": "Судебный приказ", // Вид исполнительного документа
      "officer_name": "********* О. О.", // Пристав
      "officer_phones": [
        [С
          " +7(862)261-18-60",
          "+7(862)261-34-76"
        ]
      ],
      // Информация о запросе
    "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
    }
  ]
}

Если неверно переданы данные или результат не найден

{
  "status":200,
  "count":0,
  "message":"В базе ФССП отсутствует",
  "inquiry":
  {
    "price":1.4,
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed":3,
    "attempts":1
  }
}

Реестр розыска по исполнительным производствам

Пример запроса "Реестр розыска по исполнительным производствам" HTTP GET на URL нашего API

https://api-cloud.ru/api/fssp.php?type=wanted&fio=Иванов Иван Иванович&token=53ba1b7a55abb*****7eff3a5220792

Пример успешного запроса по типу wanted с сайта ФССП в формате JSON

{
  "status": 200, // Статус ответа
  "countAll": 4309, // Всего найдено записей
  "pagesAll": 288, // Всего найдено страниц
  "totalLoadedCount": 405, // Всего загружено записей
  "totalLoadedPage": 27, // Всего загружено страниц
  // Массив с результатами
  "records": [
    {
      "investigatedName": "ИВАНОВ ИВАН ИВАНОВИЧ", // Данные об объявлении розыска должника, его имущества или ребенка
      "birthDate": "02.09.1111", // Дата рождения
      "debtorAddress": "111555,77,,,,СВОБОДНЫЙ ПР-КТ", // Адрес должника
      "searchCategory": "должник — физическое лицо", // Объект розыска	
      "searchDocnumber": "*****/**/**/** */", // Розыскное дело, №
      "searchDate": "2025-05-15", // Розыскное дело, Дата
      "ipNumber": "*****/25/*****-ИП", // Исполнительное производство, №
      "ipRisedate": "2025-03-16", // Исполнительное производство, Дата
      "ipNumberCompl": "", // Исполнительное производство завершено
      "depInitName": "СМО по ИДРЗ", // Наименование ОСП, где осуществляется розыск
      "depInitAdr": "123423, Россия, г. Москва, , , , Маршала Жукова пр-кт, д. 35, корп. 1,", // Адрес ОСП
      "depInitCode": "77044", // Код ОСП
      "depInitPhone": "" // Телефон дежурной части ТО ФССП России
    },
    {
      "investigatedName": "ИВАНОВ ИВАН ИВАНОВИЧ",
      "birthDate": "20.09.1111",
      "debtorAddress": "393480, , 68, УВАРОВСКИЙ, БЕРЕЗОВКА, , ПРОЕЗЖАЯ,",
      "searchCategory": "должник — физическое лицо",
      "searchDocnumber": "*****/**/**/** */",
      "searchDate": "2025-07-22",
      "ipNumber": "*****/23/*****-ИП",
      "ipRisedate": "2022-07-13",
      "ipNumberCompl": "",
      "depInitName": "ОСП по Уваровскому и Мучкапскому районам",
      "depInitAdr": "393460, , Тамбовская обл., Уваровский р-он, г. Уварово, мкр. 3, , д. 2, корп. А,",
      "depInitCode": "68027",
      "depInitPhone": "+7(47558)4-66-01"
    }
  ],
  "inquiry": {
    "price": 0.6,
    "balance": -706.62,
    "credit": 20000,
    "speed": 42,
    "attempts": 1
  }
}

Запрос на поиск физического лица

Пример запроса "Реестр должников по алиментным обязательствам" HTTP GET на URL нашего API

https://api-cloud.ru/api/fssp.php?type=alim&lastname=ФАМИЛИЯ&firstname=ИМЯ&secondname=ОТЧЕСТВО&birthdate=ДАТА_РОЖДЕНИЯ&region=НОМЕР_РЕГИОНА&token=53ba1b7a55********a97eff3a5220792

Пример успешного запроса по типу alim с сайта ФССП в формате JSON

{
  "status": 200, // Статус запрос
  "countAll":"53", // Всего записей
  "pagesAll":"3", // Всего страниц найдено
  "count": 1, // Количество записей в результате
  "totalLoadedPage": 3, // Загружено страниц в результате (по умолчанию загружается 25 страниц)
  "onlyActual":0, // Активность фильтра "Только актуальные делопроизводства" 
	// Результат
  "records": [
    {
      "debtor_name": "ФИО", // ФИО должника
      "debtor_address": "РОССИЯ *********************", // Место рождения
      "debtor_dob": "31.03.****", // Дата рождения
      "process_title": "197****/21/*****-ИП", // Номер исполнительного производства
      "process_date": "26.11.2021", // Дата начала делопроизводства
      "process_total": "270000/00/54007-СД", // Сводное исполнительное производство
      "recIspDoc": "Судебный приказ от 27.07.2021 № 2А-1****/**** СУДЕБНЫЙ УЧАСТОК № **** *********** ВНУТРИГОРОДСКОГО ОКРУГА Г. *******", // Реквизиты исполнительного документа (вид, дата принятия органом, номер, наименование органа, выдавшего исполнительный документ)
      
      // Реквизиты исполнительного документа 
      "recIspDocDetail": [
        "doc_organization": "СУДЕБНЫЙ УЧАСТОК № **** *********** ВНУТРИГОРОДСКОГО ОКРУГА Г. *******", // наименование органа, выдавшего исполнительный документ
        "doc_claimer_inn": "11111111111", // ИНН взыскателя-организации
        "doc_type": "Судебный приказ", // вид
        "doc_date": "27.07.2021", // дата принятия органом
        "document_num": "2А-1****/****" // Номер документа
      ],
      "stopIP": "23.08.2024, ст. 46, ч. 1, п. 3", // Дата, причина окончания или прекращения ИП, статья, часть, пункт основания
      "stopIPDate": "23.08.2024", // Дата, причина окончания или прекращения ИП
      "stopIPReason": "ст. 46, ч. 1, п. 3", // статья, часть, пункт основания
      "subject": "Взыскание налогов и сборов, включая пени (кроме таможенных)", // Вид взыскания (Предмет исполнения)
      // Массив с предметами погашения и не погашенной задолженности
      "subjectArray": [
        {
          "title": "Задолженность по алиментам", // Наимнование
          "sum": " 18422.50 руб." // Сумма
        },
        {
          "title": "Исполнительский сбор", // Наимнование
          "sum": " 1605.62 руб." // Сумма
        }
      ],
      "sum": "20028.12", // Общая сумма непогашенной задолженности
      "document_organization": "ОСП по ************* г. **** *****, г. *************", // Отдел судебных приставов
      
      "department_title": "ОСП по Куйбышевскому и Барабинскому районам", // Наименование отдела судебных приставов
      "department_address": "632387, Россия, Новосибирская обл., Куйбышевский р-н, г. Куйбышев, , ул. Краскома, д. 1, ,", // Адрес отдела судебных приставов
      
      "document_type": "Судебный приказ", // Вид исполнительного документа
      "officer_name": "********* О. О.", // Пристав
	  // Контакты пристава
      "officer_phones": [
        [
          "+786*********"
        ]
      ],
    }
  ]
  // Информация о запросе
    "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

История изменений API ФССП

дата	что изменилось
31.08.2025	Во всех методах в помощь ключу stopIP дополнительно добавлен ключ stopIPDate (Дата, причина окончания или прекращения ИП) и ключ stopIPReason (статья, часть, пункт основания)
19.08.2025	Добавлен новый метод "wanted" Реестр розыска по исполнительным производствам
17.07.2025	Для всех методов добавлены новые ключи в выводе: department_title - наименование отдела судебных приставов department_address - адрес отдела судебных приставов
09.07.2025	Для всех методов добавлены новые виды Территориальных органов (region): '80' => 'Донецкая Народная Республика', '81' => 'Луганская Народная Республика', '98' => 'Главное межрегиональное (специализированное) управление', '99001' => 'Отдел по исполнению особо важных исполнительных производств', '99003' => 'Федеральная территория «Сириус»',
08.07.2025	1. Добавили в ответ заголовок Content-type: application/json; charset=utf-8 2. Во все методы добавлен массив (recIspDocDetail) расшифровывающий реквизиты исполнительного документа: * наименование органа, выдавшего исполнительный документ; * ИНН взыскателя-организации; * Вид; * Дата принятия органом; * Номер документа
26.06.2025	Методы ip и id: Выпустили фикс исправляющий большинство ошибок "Источник не доступен" когда страниц было несколько. Так же обратите внимание, что метод id в данный момент работает корректно только при поиске с указанием конкретного региона.
28.11.2024	Сегодня вышло крупное обновление в связи с изменениями на источнике: 1. Теперь не обязательно указывать параметр searchAll=1 или иные параметры для указания количества загружаемых страниц в результате. Теперь грузятся все страницы в результате. 2. В ответе добавили массив subjectArray. Массив с предметами погашения и не погашенной задолженности в разрезе. 3. Ключ sum теперь содержит сумму всех задолженностей, включая иные сборы. 4. Добавили ключ process_total. Информация о сводном исполнительном производстве. 5. Ключ document_type теперь четко обозначает вид исполнительного документа. Если у вас работающий код, то изменения никакие вносить не нужно. Изменения в обновлении связаны с дополнительной структурированной информацией.
18.10.2024	Метод: legal Скорректирован вывод. Ранее в debtor_dob выводился адрес должинка, а в debtor_address инн. Теперь в debtor_dob выводится ИНН должника, а в debtor_address адрес должника.
25.03.2024	В связи с решением ошибки фильтрации на стороне источника, отменены ранее введенные запреты на следующие даты рождения: 01.04.1981, 01.04.1982, 01.04.1983, 01.04.1984
06.03.2024	Добавлен новый метод запроса "id" Отправить запрос на поиск по номеру исполнительного производства
01.03.2024	Добавили новый обработчик ошибки, который срабатывает в случае, если в запросе Фамилия и Имя имееют одинаковые значения. Ошибка: {"error":"107","message":"CONFLICT_LASTNAME_FIRSTNAME"} Описание: Фамилия (lastname) и Имя (firstname) должны различаться
22.02.2024	Временно ввели ограничение на параметр birthdate, в связи с ошибкой в фильтрации у источника ФССП после обновления. Даты рождения: 01.04.1981, 01.04.1982, 01.04.1983, 01.04.1984 не принимаются. Если такие будут переданы, то будет получена ошибка {"error":"104","message":"MISSING_REQUIRED_birthdate_PARAMETER"} Следим за ситуацией и вернем после исправления на источнике.
16.02.2024	Метод запроса physical. Ранее удавалось отправлять запросы без параметра birthdate (Дата рождения). Теперь этот параметр обязателен при передаче запроса. Он должен быть передан в каждом запросе и строго соответствовать маске ДД.ММ.ГГГГ. Если в дате будет не точность, то будет ошибка {"error":"015","message":"DATE_ERROR"} Если обязательный параметр birthdate будет отсутствовать, то ошибка {"error":"104","message":"MISSING_REQUIRED_birthdate_PARAMETER"} Если вы не передавали ранее параметр birthdate (Дата рождения), то необходимо включить его в свои запросы.
27.06.2023	Адаптация под источник
28.03.2023	1. Для методов запросов physical, legal, inn добавили фильтр "Только актуальные делопроизводства". Чтобы в выводе отображались делопроизводства у которых stopIP пусто. 2. В ответе так же добавили указание типа поиска (onlyActual = 1/0)
28.12.2022	Переработан алгоритм работы API. Получили прирост производительности.
22.11.2022	Доступен новый метод запроса (inn). Поиск задолженности юридического лица по ИНН. Новый метод запроса описан в документации.
21.11.2022	Восстановили метод запроса Юридически лиц (legal). Работает аналогично запросу по поиску Физического лица (physical)
31.10.2022	Работа запроса по типу ip (поиск по номеру делопроизводства) восстановлена.
23.10.2022	В результат ответа добавлен массив inquiry, отвечающий за информацию о запросе. Ранее он отсутствовал, когда записи были найдены.
23.10.2022	В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса.
07.09.2022	Обновлен алгоритм работы
03.09.2022	По типу запроса "ip" поправили ошибку, при которой возвращался пустой ответ. Сейчас ответы корректно возвращаются.
29.04.2022	В передаче параметров разрешена буква "ё". Ранее это был запретный символ.
05.04.2022	Переработан алгоритм обработки.
15.03.2022	Переписан алгоритм API
17.04.2021	Добавили проверку доступности сервиса решения капч. Если сервис недоступен, то средства за запрос не снимаются. Вы сможете отправить запрос позднее, когда сервис будет вновь доступен. Код ошибки: 999. SERVICE_CAPTCHA_OFFLINE

Возможные коды ошибок

код (error)	Описание ошибки (message)
888	ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы
766	MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры
602	TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса
504	TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой
503	TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе
502	MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token
500	MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
107	TYPEID_NOT_CORRECTED Параметр typeid не корректен, смотрите доступный список в документации
107	CONFLICT_LASTNAME_FIRSTNAME Фамилия (lastname) и Имя (firstname) должны различаться
106	MISSING_REQUIRED_number_PARAMETER Отсутствует параметр number или указан неверно
105	MISSING_REQUIRED_nameLegal_PARAMETER Отсутствует параметр nameLegal или указан неверно
104	MISSING_REQUIRED_birthdate_PARAMETER Отсутствует обязательный параметр birthdate
103	MISSING_REQUIRED_region_PARAMETER Отсутствует параметр region или указан неверно
102	MISSING_REQUIRED_number_PARAMETER Отсутствует параметр number или указан неверно
101	MISSING_REQUIRED_lastname_PARAMETER Отсутствует параметр lastname или указан неверно
100	MISSING_REQUIRED_firstname_PARAMETER Отсутствует параметр firstname или указан неверно
15	DATE_ERROR Ошибка значения переданной даты
5	TEST_TIME_OFF Закончился период тестирования
3	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
2	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
1	API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

Пример ответа с ошибкой

{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}

Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.

Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

Список typeid для метода id

typeid	Тип исполнительного документа
1	Исполнительный документ
2	Нотариально удостоверенное соглашение об уплате алиментов
3	Акт по делу об административном правонарушении
4	Судебный приказ
5	Акт органа, осуществляющего контрольные функции
6	Удостоверение комиссии по трудовым спорам
7	Акт другого органа
8	Постановление судебного пристава-исполнителя
10	Исполнительная надпись нотариуса
11	Судебный акт по делу об административном правонарушении
12	Запрос центрального органа о розыске ребенка
13	Исполнительный документ, выданный компетентным органом иностранного государства
16	Удостоверение, выданное уполномоченным по правам потребителей финансовых услуг в порядке, предусмотренном Федеральным законом от 04.06.2018 № 123-ФЗ Об уполномоченном по правам потребителей финансовых услуг
17	Определение судьи о наложении ареста на имущество в целях обеспечения исполнения постановления о назначении административного наказания за совершение административного правонарушения, предусмотренного статьей 19.28 Кодекса Российской Федерации об админист
18	Нотариально удостоверенное медиативное соглашение
19	Решение государственного инспектора труда о принудительном исполнении обязанности работодателя по выплатам, осуществляемым в рамках трудовых отношений