Контур.Фокус API: Проверить статус самозанятого

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

Асинхронная проверка физлица на НПД перед выплатой.

Зарегистрируй задачу: GET /api3/smzSendToCheck?innfls=... (до 100 ИНН через запятую) — в ответе taskId.
Проверяй результат: GET /api3/smzGetStatus?guid={taskId} — taskStatus, затем smzStatusResult[].isSmz и history.

curl "https://focus-api.kontur.ru/api3/smzSendToCheck?key=$FOCUS_KEY&innfls=$INNFL"

curl "https://focus-api.kontur.ru/api3/smzGetStatus?key=$FOCUS_KEY&guid=$TASK_ID"

Базовые 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/smzSendToCheck — Задача на проверку самозанятого

В ответе taskId (GUID).

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

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

GET /api3/smzGetStatus — Результат проверки самозанятого

В ответе: taskStatus, smzStatusResult[] (innfl, isSmz, history).

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

Параметр	Где	Тип	Обяз.	Описание
`key`	query	string	да	Ключ доступа
`guid`	query	string	да	taskId из smzSendToCheck
`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