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

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

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

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

function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,250); // Установите максимальный таймаут ожидания ответа
		$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.
История изменений/обновлений

types	Описание	Параметры в запросе
	В одном запросе возможно отправить только 1 тип
regionsList	Получить список регионов для параметра "region" Плата за обработку запроса не списывается.	Обязательные token - персональный ключ API
physical	Отправить запрос на поиск физического лица • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные lastname - Фамилия Разрешено: кирилица, латиница, цифры, знак "-" firstname - Имя Разрешено: кирилица, латиница, цифры, знак "-" birthdate - Дата рождения в формате дд.мм.гггг Разрешено: цифры, знак "." region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") Разрешено: цифры, знак "-" token - персональный ключ API Дополнительные secondname - Отчество Разрешено: кирилица, латиница, цифры, знак "-" searchAll=1 - Вывод результата из 4х страниц onlyActual=1 - Фильтр "Только актуальные делопроизводства"
legal	Отправить запрос на поиск юридического лица • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные nameLegal - Имя юридического лица Разрешено: кирилица, латиница, цифры, знак "-" region - Номер региона (список доступен через тип запроса "regionsList") Разрешено: кирилица, латиница, цифры, знак "-" token - персональный ключ API Дополнительные address - Адрес юридического лица Разрешено: кирилица, латиница, цифры, знак "-" searchAll=1 - Вывод результата из 4х страниц onlyActual=1 - Фильтр "Только актуальные делопроизводства"
ip	Отправить запрос на поиск по номеру исполнительного производства • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные number - Номер исполнительного документа в формате n…n/yy/dd/rr или n…n/yy/ddddd-ИП Разрешено: кирилица, латиница, цифры, знак "/" token - персональный ключ API
id ^new!	Отправить запрос на поиск по номеру исполнительного документа • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные number - Номер исполнительного производства Разрешено: цифры token - персональный ключ API Дополнительные region - Номер региона (список доступен через тип запроса "regionsList") Разрешено: цифры, знак "-"
inn	Отправить запрос на поиск юридического лица по ИНН • Данные должника • Номер дела • Дата дела • Вид дела • Сумма • Организация инициатор • Тип дела • Дата вынесения дела • Номер документа • Информация о департаменте • Информация о приставе • Контакты пристава	Обязательные inn - ИНН организации Разрешено: цифры region - Номер региона (Поиск по всем регионам "-1" в значении. Список доступен через тип запроса "regionsList") Разрешено: цифры, знак "-" token - персональный ключ API Дополнительные searchAll=1 - Вывод результата из 4х страниц onlyActual=1 - Фильтр "Только актуальные делопроизводства"

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

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

Пример запроса "Запрос на поиск физического лица" 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, // Загружено страниц в результате (по умолчанию загружается 1 страница, возможно загрузить максимум 4 страницы при переданном параметре searchAll=1)
  "onlyActual":0, // Активность фильтра "Только актуальные делопроизводства" 
	// Результат
  "records": [
    {
      "debtor_name": "ФИО", // ФИО должника
      "debtor_address": "РОССИЯ *********************", // Место рождения
      "debtor_dob": "31.03.****", // Дата рождения
      "process_title": "197****/21/*****-ИП", // Номер исполнительного производства
      "process_date": "26.11.2021", // Дата начала делопроизводства
      "recIspDoc": "Судебный приказ от 27.07.2021 № 2А-1****/**** СУДЕБНЫЙ УЧАСТОК № **** *********** ВНУТРИГОРОДСКОГО ОКРУГА Г. *******", // Реквизиты исполнительного документа (вид, дата принятия органом, номер, наименование органа, выдавшего исполнительный документ)
      "stopIP": "", // Окончание делопроизводства
      "subject": "Взыскание налогов и сборов, включая пени (кроме таможенных)", // Вид взыскания (Предмет исполнения)
      "sum": "142.12", // Сумма непогашенной задолженности
      "document_organization": "ОСП по ************* г. **** *****, г. *************", // Отдел судебных приставов
      "document_type": "Взыскание налогов и сборов, включая пени (кроме таможенных): 142.12 руб. ", // Предмет исполнения, сумма непогашенной задолженности
      "officer_name": "********* О. О.", // Пристав
	  // Контакты пристава
      "officer_phones": [
        [
          "+786*********"
        ]
      ],
      // Информация о запросе
    "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
    }
  ]
}

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

{
  "status":200,
  "count":0,
  "message":"В базе ФССП отсутствует",
  "inquiry":
  {
    "price":1.4,
    "balance": 100462.11, // Баланс после текущего запроса
    "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, // Загружено страниц в результате (по умолчанию загружается 1 страница, возможно загрузить максимум 4 страницы при переданном параметре searchAll=1)
  "onlyActual":0, // Активность фильтра "Только актуальные делопроизводства" 
  // Результат
  "records": [
    {
      "debtor_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АПТЕКА-23\"",
      "debtor_address": " РОССИЯ,353560,КРАСНОДАРСКИЙ КРАЙ, СОЧИ Г, КОВТЮХА УЛ,14",
      "process_title": "9**95/20/2**60-ИП",
      "process_date": "23.10.2020",
      "subject": "Взыскание налогов и сборов, включая пени",
      "sum": "11040",
      "document_organization": "МЕЖРАЙОННАЯ ИНСПЕКЦИЯ ФЕДЕРАЛЬНОЙ НАЛОГОВОЙ СЛУЖБЫ № 11 ПО КРАСНОДАРСКОМУ КРАЮ",
      "document_type": "Акт органа, осуществляющего контрольные функции",
      "document_date": "20.10.2020",
      "document_num": "2**6",
      "department": "*** ГОСП 35***0, Россия, Краснодарский край, , г. ****, , ул. Набережная, д. 13 а, , ",
      "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, // Баланс после текущего запроса
    "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,А", // Адрес
      "process_title": "32472/17/23072-ИП", // Номер исполнительного делопроизводства
      "process_date": "18.05.2017 1555/19/23072-СД", // Дата постановления
      "subject": "Взыскание налогов и сборов, включая пени", // Вид
      "sum": "28627.43", // Сумма
      "document_organization": "Постановление о взыскании исполнительского сбора МЕЖРАЙОННАЯ ИНСПЕКЦИЯ ФЕДЕРАЛЬНОЙ НАЛОГОВОЙ СЛУЖБЫ № 7 ПО КРАСНОДАРСКОМУ КРАЮ",
      "document_type": "Акт органа, осуществляющего контрольные функции",
      "document_date": "10.05.2017",
      "document_num": "50993",
      "department": "Центральное РОСП г.Сочи 354057, Россия, Краснодарский край, , г. Сочи, , ул. Севастопольская, 25, , ",
      "officer_name": "РОДИОНОВА Т. Е.",
      "officer_phones": [
        [
          " +7(862)261-18-60",
          "+7(862)261-34-76"
        ]
      ],
      // Информация о запросе
    "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
    }
  ]
}

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

{
  "status":200,
  "count":0,
  "message":"В базе ФССП отсутствует",
  "inquiry":
  {
    "price":1.4,
    "balance": 100462.11, // Баланс после текущего запроса
    "speed":3,
    "attempts":1
  }
}

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

дата	что изменилось
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	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 или указан неверно
015	DATE_ERROR Ошибка значения переданной даты
005	TEST_TIME_OFF Закончился период тестирования
001	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":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}