Контур.Фокус API: Проверить надёжность контрагента перед сделкой

Сценарий из mcp-everything. Актуально на 2026-10-25.

Сводная проверка рисков: экспресс-отчёт, скоринг, признаки из реестров ФНС и долги у приставов.

1. GET /api3/briefReport — экспресс-отчёт с ключевыми факторами (есть вариант pdf=true).
2. GET /api3/scoring — рейтинг 0–100 по моделям проверки; ratingLevel: Low, Middle, High; triggeredMarkers — что повлияло.
3. GET /api3/legalAnalytics — недостоверность адреса или руководителя, блокировка счетов ФНС, налоговый долг, непредставление отчётности, заявления о ликвидации и смене руководителя.
4. GET /api3/financeAnalytics — выручка, прибыль, чистые активы, налоги и долги по налогам.
5. GET /api3/fssp — исполнительные производства (по 1000 записей, дальше skip=1000).

curl "https://focus-api.kontur.ru/api3/briefReport?key=$FOCUS_KEY&inn=6663003127"

curl "https://focus-api.kontur.ru/api3/scoring?key=$FOCUS_KEY&inn=6663003127"

curl "https://focus-api.kontur.ru/api3/legalAnalytics?key=$FOCUS_KEY&inn=6663003127"

curl "https://focus-api.kontur.ru/api3/fssp?key=$FOCUS_KEY&inn=6663003127"

Базовые URL

• Боевой: https://focus-api.kontur.ru

Авторизация

Тип: API-ключ

Ключ доступа передаётся параметром key в строке запроса. Тестовый ключ выдают по заявке: https://focus.kontur.ru/site/api/order-api. Для ключей с лимитом больше 100 000 компаний или запросов обязателен второй фактор: ограничение по IP-диапазонам или подпись каждого запроса сертификатом (настраивает техподдержка, focus-api@kontur.ru).

Методы сценария

GET /api3/briefReport — Экспресс-отчёт

Краткая характеристика контрагента с ключевыми факторами по открытым и официальным источникам.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FbriefReport

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
inn	query	string	нет	ИНН, до 100 через запятую
ogrn	query	string	нет	ОГРН, до 100 через запятую
xml	query	boolean	нет	Отчёт в XML
pdf	query	string	нет	true — отчёт в PDF

GET /api3/scoring — Скоринговая оценка

scoringData[]: modelId, modelName, rating (0–100), ratingLevel (Low 0–39, Middle 40–69, High 70–100), triggeredMarkers.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Fscoring

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
inn	query	string	нет	ИНН, до 100 через запятую
ogrn	query	string	нет	ОГРН, до 100 через запятую
xml	query	boolean	нет	Ответ в XML

GET /api3/legalAnalytics — Юридические признаки

legalAnalyticsData: недостоверность адреса, руководителя, учредителя (unreliableAddress, unreliableManager, unreliableFounder), блокировка счетов ФНС (bankAccountFnsBlock), налоговый долг (fnsHasTaxDebt), непредставление отчётности (fnsTaxReportMissing), дисквалификация руководителей, заявления о ликвидации и смене руководителя, численность, МСП, спецрежимы. У каждого признака есть isActual.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FlegalAnalytics

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
inn	query	string	нет	ИНН, до 100 через запятую
ogrn	query	string	нет	ОГРН, до 100 через запятую

GET /api3/financeAnalytics — Оценка по финансам и налогам

financeAnalyticsData: последний год отчётности, выручка, баланс, чистая прибыль и чистые активы на начало и конец периода, уплаченные налоги, долги и штрафы по налогам, экспертный рейтинг отчётности.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FfinanceAnalytics

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
inn	query	string	нет	ИНН, до 100 через запятую
ogrn	query	string	нет	ОГРН, до 100 через запятую

GET /api3/fssp — Исполнительные производства

fssp[]: officialNum, startDate, sum, topic, executoryDocument, cancelDate, bailiffDepartment и др.; updateDate — актуальность данных. Для ИП сведения есть, только если обновлялись в веб-версии.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Ffssp

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
inn	query	string	нет	ИНН; обязателен, если нет ОГРН
ogrn	query	string	нет	ОГРН
skip	query	integer	нет	Пропустить N записей (по 1000 на страницу: skip=1000, …)
xml	query	boolean	нет	Ответ в XML

Нюансы

• Большинство методов принимают ИНН или ОГРН и до 100 значений через запятую; ответ — массив по каждой компании.
• Формат по умолчанию JSON; xml=true переключает на XML (методы наблюдения — только JSON).
• focusHref ведёт в веб-карточку Фокуса — для неё нужна подписка на сервис.
• Методы /api3/analytics и /api3/buh устарели: используйте группу новых аналитических методов и /api3/accountingReports.
• Старое наблюдение (/api3/monList, /api3/req/mon, /api3/egrDetails/mon) поддерживается, но рекомендуется NEW Наблюдение (monitoringList, monitoringGetStates, monitoringGetChanges).
• Изменения в NEW Наблюдении хранятся 90 дней; changeId растёт, но не обязательно подряд.
• Самозанятые: лимит считается по уникальным ИНН в сутки (сброс в 00:00 UTC); с 21:00 до 00:00 МСК возможны техработы.
• Есть игровой стенд с формами методов (например, https://focus-api.kontur.ru/api3/req/userform).

Другие сценарии

• Заполнить реквизиты контрагента по ИНН
• Найти компанию по названию
• Проверить пакет контрагентов
• Отслеживать изменения у контрагентов
• Проверить статус самозанятого

---

Если этого недостаточно — официальная документация: https://developer.kontur.ru/doc/focus-v2 Вся интеграция одним документом: https://mcp-everything.ru/integrations/kontur-focus.md