Блокировка счетов
Возвращает сведения о блокировке (приостановлении) операций по расчётным счетам контрагента по данным ФНС. Можно запросить по ОГРН или ИНН.
GET
https://kontrchk.ru/api/v2/blocked_accounts
- Ответ обёрнут в success/data, как у большинства методов API v2.
- Поле block или is_blocked указывает на наличие блокировки. При block=false счета не заблокированы.
- Поле doc_result может содержать base64-справку ФНС; в документации показана сокращённая структура без бинарных данных.
- Ответ кэшируется на сервере (TTL 12 часов).
Параметры запроса
| Параметр | Тип | Описание | |
|---|---|---|---|
key
|
string | обязательный |
API-ключ. Также можно передать в заголовке X-API-Key. |
ogrn
|
string | обязательный |
ОГРН (13 цифр) или ОГРНИП (15 цифр). Можно указать inn вместо ogrn. |
inn
|
string | необязательный |
ИНН организации (10 цифр). Используется, если не указан ogrn. |
Пример запроса
URL
https://kontrchk.ru/api/v2/blocked_accounts?key=ВАШ_КЛЮЧ&ogrn=1027700132195
cURL
curl -s -H "Accept: application/json" "https://kontrchk.ru/api/v2/blocked_accounts?key=ВАШ_КЛЮЧ&ogrn=1027700132195"
Ответ
Успешный ответ пример ответа
blockbooleanПризнак блокировки счетов.
Пример:
falseblocking_idinteger|nullИдентификатор записи о блокировке.
has_docbooleanДоступна ли справка ФНС (doc_result не пуст).
Пример:
trueblocksarray[object]Альтернативный массив блокировок.
accountsarray[object]Заблокированные счета.
Пример JSON
{
"success": true,
"data": {
"block": false,
"blocking_id": null,
"has_doc": true,
"items": []
}
}
Ошибка
| Поле | Тип | Описание |
|---|---|---|
success
|
boolean |
Признак ошибки: false. |
error
|
string |
Текст ошибки. |
Пример JSON
{
"success": false,
"error": "Укажите параметр ogrn или inn"
}